Développeurs

L’identité produit en un appel d’API.

Créez des produits, publiez des passeports et enregistrez des unités depuis vos propres systèmes. Les produits d’un projet apparaissent aussi dans le tableau de bord.

Obtenir une clé d’API Lire la documentation

Démarrage rapide

De la clé à l’unité enregistrée.

Créez un compte et un projet pour votre secteur, puis une clé API de projet dans les paramètres de ce projet. Les produits créés avec cette clé apparaissent dans le tableau de bord. Indiquez votre propre GTIN dans l’exemple. Cet exemple partiel enregistre un brouillon, et le lien ouvre un passeport dès que tous les champs obligatoires sont valides. L’étape 2 nécessite l’internalId du produit, fourni par GET /v1/products.

1. Sauvegardez le passeport · POST /v1/passports

{
  "gtin": "YOUR_GTIN",
  "name": "Voltaic VX-48-900 e-bike battery",
  "brand": "Voltaic",
  "category": "battery",
  "data": {
    "productType": "battery",
    "category": "lmt",
    "identity": {
      "manufacturerName": "Voltaic Energy Systems GmbH",
      "modelIdentifier": "VX-48-900",
      "chemistry": "NMC",
      "capacityAh": 18.8,
      "weightKg": 4.6,
      "rechargeable": true
    }
  }
}

2. Enregistrez une unité · POST /v1/products/{id}/items

curl -X POST \
  "https://api.eulabel.eu/v1/products/$PRODUCT_ID/items" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serialNumber": "VX48-2609-000117",
    "lotNumber": "L2609-A",
    "lifecycleStatus": "original"
  }'

3. Scannez-le une fois publié

https://eulabel.eu/01/YOUR_GTIN/21/VX48-2609-000117

Surface de l’API

Possible dès aujourd’hui.

Produits: Créez et importez des produits, avec validation du GTIN.
Passeports: Publiez, versionnez et retirez, avec validation champ par champ.
Unités: Enregistrez des numéros de série et consignez les événements du cycle de vie.
Profils: Lisez le catalogue de champs de chaque secteur en JSON.
Droits d’accès: Émettez et révoquez des jetons pour les destinataires restreints.
Codes QR et domaines: Générez des codes et vérifiez des domaines personnalisés.

Pour les agents aussi

Une doc lisible par machine.

Chaque page de la documentation a une version markdown, et nous publions llms.txt et llms-full.txt, afin que vos agents travaillent à partir de la source.

Commencez par un produit.

L’accès anticipé est gratuit et ouvert aux producteurs des quatre secteurs. Vos codes QR continuent de fonctionner quand les règles évoluent.

Créer un compte gratuit