Zum Inhalt springen

Entwickler

Produktidentität als API-Aufruf.

Erstellen Sie Produkte, veröffentlichen Sie Pässe und registrieren Sie Einheiten aus Ihren eigenen Systemen. Produkte in einem Projekt erscheinen auch im Dashboard.

Schnellstart

Vom Schlüssel zur registrierten Einheit.

Erstellen Sie ein Konto und ein Projekt für Ihren Sektor, dann in den Projekteinstellungen einen Projekt-API-Schlüssel. Mit diesem Schlüssel erstellte Produkte erscheinen im Dashboard. Tragen Sie im Beispiel Ihre eigene GTIN ein. Dieses unvollständige Beispiel speichert einen Entwurf, und der Link öffnet einen Pass, sobald alle Pflichtfelder gültig sind. Schritt 2 braucht die internalId des Produkts aus GET /v1/products.

1. Pass speichern · 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. Einheit registrieren · 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. Nach der Veröffentlichung scannen
https://eulabel.eu/01/YOUR_GTIN/21/VX48-2609-000117

Die API-Oberfläche

Was heute möglich ist.

Produkte
Produkte anlegen und importieren, mit GTIN-Validierung.
Pässe
Veröffentlichen, versionieren und zurückziehen, mit Validierung pro Feld.
Einheiten
Seriennummern registrieren und Lebenszyklusereignisse erfassen.
Profile
Den Feldkatalog jedes Sektors als JSON lesen.
Zugriffsrechte
Tokens für eingeschränkte Zielgruppen ausstellen und widerrufen.
QR-Codes und Domains
Codes erzeugen und eigene Domains verifizieren.

Auch für Agenten

Maschinenlesbare Dokumentation.

Jede Dokumentationsseite hat eine Markdown-Version, und wir veröffentlichen llms.txt und llms-full.txt, damit Ihre Agenten mit der Quelle arbeiten.

Beginnen Sie mit einem Produkt.

Der Vorabzugang ist kostenlos und steht Herstellern in allen vier Sektoren offen. Ihre QR-Codes funktionieren weiter, auch wenn sich die Regeln ändern.