API v1.0

Documentation API

Intégrez la création et la gestion de Passeports Numériques directement dans vos systèmes ERP, PIM ou applications métier. L'API REST suit les standards OpenAPI 3.0.

REST / JSON Bearer Token Rate limit: 1000 req/h

BASE URL

https://api.atlasnextrade.com/api/v1

Authentification

Toutes les requêtes authentifiées nécessitent un header Authorization avec votre clé API.

http

Authorization: Bearer YOUR_API_KEY

Obtenir votre clé API : Connectez-vous à votre tableau de bord, puis allez dans Paramètres → Clés API pour générer une nouvelle clé.

Démarrage rapide

bash

# 1. Obtenir votre clé API
# Connectez-vous et allez dans Paramètres > API

# 2. Authentification Bearer Token
curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.atlasnextrade.com/api/v1/dpps

# 3. Créer un DPP
curl -X POST https://api.atlasnextrade.com/api/v1/dpps \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "productName": "T-Shirt Coton Bio",
    "sector": "textile",
    "carbonFootprint": "2.3"
  }'

Endpoints

📋 Passeports Numériques (DPP)

✅ Conformité & Audit

📱 QR Codes & Liens publics

🎫 Passport Service (DAL §3)

📡 EPCIS Integration Service (GS1 EPCIS 2.0)

📂 File Service (Isolation S3 par artisan)

🏺 Product Service (CRUD Artisanal)

Codes d'erreur

Code HTTP	Signification	Action recommandée
`200`	OK	Requête réussie
`201`	Created	Ressource créée avec succès
`400`	Bad Request	Vérifiez les paramètres de la requête
`401`	Unauthorized	Vérifiez votre clé API
`403`	Forbidden	Vous n'avez pas accès à cette ressource
`404`	Not Found	La ressource n'existe pas ou a été supprimée
`429`	Too Many Requests	Attendez avant de réessayer (rate limit)
`500`	Server Error	Contactez le support si le problème persiste

SDKs & Exemples de code

⬡ JavaScript / TypeScript

javascript

import axios from 'axios';

const client = axios.create({
  baseURL: 'https://api.atlasnextrade.com/api/v1',
  headers: { Authorization: `Bearer ${process.env.DPP_API_KEY}` }
});

// Lister vos DPP
const { data } = await client.get('/dpps', {
  params: { sector: 'textile', status: 'published' }
});

// Créer un DPP
const newDpp = await client.post('/dpps', {
  productName: 'Mon Produit',
  sector: 'electronique',
  carbonFootprint: '5.2',
  materialComposition: [
    { material: 'Aluminium', percentage: 40, origin: 'France' }
  ]
});

console.log('DPP créé:', newDpp.data.uid);

🐍 Python

python

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.atlasnextrade.com/api/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Lister les DPP
response = requests.get(f"{BASE_URL}/dpps", headers=headers)
dpps = response.json()

# Créer un DPP
new_dpp = requests.post(f"{BASE_URL}/dpps", headers=headers, json={
    "productName": "Vase en céramique artisanal",
    "sector": "ceramique",
    "carbonFootprint": "85.5"
})

print(f"DPP créé: {new_dpp.json()['uid']}")

Webhooks

Configurez des webhooks pour recevoir des notifications en temps réel lors d'événements sur vos DPP.

dpp.createdUn nouveau DPP a été créé

dpp.publishedUn DPP a été publié

dpp.updatedUn DPP a été mis à jour

passport.createdUn Passeport Artisanal a été créé

certification.failedUn DPP a échoué au contrôle de certification artisanale

qr.scannedUn QR code a été scanné

La configuration des webhooks est disponible dans votre tableau de bord sous Paramètres → Webhooks. Chaque événement est signé avec HMAC-SHA256 pour garantir l'authenticité.