Offre API · Autonome

Vos données produit.
Vos outils. Une API pour les relier.

Souscrivez à l’API seule pour créer vos passeports produits, générer vos QR codes et préparer vos puces NFC depuis votre ERP, votre PIM ou votre application. Aucun abonnement à la plateforme SaaS ou à Shopify n’est nécessaire.

Documentation publique, accès API payant. La documentation est consultable librement. L’offre API est en préparation : les accès et clés du programme pilote restent à activer avant toute utilisation du service.

Ce que vous pourrez automatiser

Du catalogue au support posé sur le produit.

L’API constitue l’une de nos trois offres, au même titre que la plateforme SaaS et l’application Shopify. Votre logiciel effectue les appels et récupère les fichiers directement : aucun passage par un tableau de bord n’est requis pour générer vos supports.

01

Transmettre les données

Envoyez les références, matières, lieux de fabrication et informations de lot depuis vos outils. Retrouvez le lien entre votre référence interne et son passeport.

02

Préparer les étiquettes

Récupérez un fichier QR code à intégrer à une étiquette, un emballage ou votre chaîne d’impression. Pour le NFC, récupérez le lien à écrire dans la puce.

03

Mettre les informations à jour

Ajoutez un contrôle ou une réparation, puis mettez à jour les informations du passeport. Le lien porté par l’étiquette reste associé au même produit.

Un parcours concret

Votre application demande. Votre atelier imprime ou encode.

  1. Créer le passeport. Votre système transmet les données du produit et choisit QR code, NFC ou les deux.
  2. Vérifier et publier. Votre équipe contrôle les informations avant de les rendre accessibles.
  3. Préparer le support physique. Le QR est imprimé sur une étiquette ; le lien NFC est écrit dans une puce avec un équipement compatible.
  4. Poser et contrôler. Un scan ou une lecture NFC vérifie que l’étiquette ouvre le bon passeport.

L’impression, le choix de l’étiquette et l’encodage font partie du déploiement. Découvrir les supports et leur mise en place.

À prévoir avec votre équipe

Un seul lien, plusieurs supports.

  • QR code : un fichier à imprimer vous-même ou à transmettre à votre imprimeur.
  • Puce NFC : un lien à encoder sur une puce compatible, puis à relire pour vérifier l’écriture.
  • QR + NFC : deux modes d’accès reliés au même passeport sur une étiquette combinée.
Voir comment récupérer les fichiers et les données via l’API →
Pour votre équipe technique

Un premier appel facile à comprendre.

Ce modèle Node.js prépare un passeport pour un exemplaire, avec les deux supports. Votre référence LOT-42-0001 permet de le retrouver dans votre propre système.

La réponse décrite dans le contrat contient l’identifiant du passeport, son statut, son lien et les ressources QR/NFC demandées. La publication fait l’objet d’une étape distincte.

Exemple de contrat, à utiliser après l’ouverture d’un environnement de test et la remise d’une clé API.

Suivre l’exemple complet et lire la réponse →

Node.js · Création d’un passeport · Contrat de test

// La clé reste dans votre application serveur.
const baseUrl = process.env.TRACE_API_URL;
const response = await fetch(`${baseUrl}/passports`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TRACE_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "LOT-42-0001"
  },
  body: JSON.stringify({
    external_id: "LOT-42-0001",
    identification_level: "item",
    product: {
      name: "Veste Atelier",
      sku: "VESTE-BLEU-M"
    },
    carriers: { qr: true, nfc: true }
  })
});

if (!response.ok) {
  throw new Error(`Création refusée : ${response.status}`);
}

const passport = await response.json();
console.log(passport.id, passport.status);
Documentation ouverte

Des ressources nommées simplement.

Chaque route ci-dessous s’ajoute à l’adresse de base /trace/v1. Le fichier OpenAPI décrit les champs, réponses et opérations prévus.

POST/productsEnregistrer une référence produit
POST/passportsCréer son passeport
POST/passports/{passportId}/publishPublier les informations validées
GET/passports/{passportId}/qr.svgTélécharger le QR à imprimer
GET/passports/{passportId}/nfc-payloadRécupérer le lien à encoder
POST/passport-batchesPréparer plusieurs passeports
Passeport numérique produit

Une intégration au service de votre démarche réglementaire.

Le choix des données, du niveau d’identification et du support doit correspondre aux exigences applicables à votre catégorie de produits. Le cadre ESPR et ses textes sectoriels guident ce travail.

L’API facilite la circulation de vos informations ; la conformité dépend aussi de leur contenu, de leur exactitude et des règles de votre secteur.

Comprendre le cadre réglementaire →
Guides pratiques

Pour préparer votre projet

Cadrez vos données, les échanges avec vos outils et le passage aux étiquettes physiques.

Programme pilote

Préparons votre intégration.

Partagez vos outils, vos volumes et vos besoins d’étiquetage pour cadrer le parcours de votre équipe.