Vai al contenuto

Sviluppatori

L’identità di prodotto via API.

Crei prodotti, pubblichi passaporti e registri unità dai Suoi sistemi. I prodotti di un progetto compaiono anche nel pannello di controllo.

Guida rapida

Dalla chiave all’unità registrata.

Crei un account e un progetto per il Suo settore, poi una chiave API di progetto nelle impostazioni del progetto. I prodotti creati con quella chiave compaiono nel pannello di controllo. Inserisca il Suo GTIN nell’esempio. Questo esempio parziale salva una bozza, e il link apre un passaporto quando tutti i campi obbligatori sono validi. Il passaggio 2 richiede l’internalId del prodotto da GET /v1/products.

1. Salvi il passaporto · 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. Registri un’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. Lo scansioni dopo la pubblicazione
https://eulabel.eu/01/YOUR_GTIN/21/VX48-2609-000117

La superficie dell’API

Cosa si può fare oggi.

Prodotti
Creazione e importazione di prodotti, con validazione del GTIN.
Passaporti
Pubblicazione, versioni e ritiro, con validazione per campo.
Unità
Registrazione dei numeri di serie ed eventi del ciclo di vita.
Profili
Lettura del catalogo di campi di ogni settore in JSON.
Autorizzazioni di accesso
Rilascio e revoca di token per i destinatari con accesso riservato.
Codici QR e domini
Generazione dei codici e verifica dei domini personalizzati.

Anche per gli agenti

Documentazione per le macchine.

Ogni pagina della documentazione ha una versione markdown e pubblichiamo llms.txt e llms-full.txt, così i Suoi agenti lavorano dalla fonte.

Parta da un prodotto.

L’accesso anticipato è gratuito e aperto ai produttori dei quattro settori. I Suoi codici QR continuano a funzionare anche quando le regole cambiano.