Ugrás a fő tartalomra
Battery Compliance
Kezdje ingyen
Menü

Fejlesztők

Kapcsolja össze ERP- vagy gyártási rendszereit: hozzon létre és tegyen közzé elem-, illetve akkumulátor-útleveleket, olvassa és frissítse őket az EN 18222 szabványt követő DPP API-n keresztül, és fogadjon eseményeket webhookon. Az API-hozzáférés minden csomagban benne van, az Ingyenes csomagban is.

Két API

  • Útlevélkezelő API

    /openapi.json

    Az útleveleket birtokló cég számára: modellek és tételek listázása (kurzorral, az updatedSince paraméterrel a szinkronizáláshoz), tételek, tartományok és modellmásolatok létrehozása, tételadatok frissítése, közzététel (egy tétel vagy a háttérben) és QR-kódok lekérése. API-kulccsal hitelesítve.

    Referencia: Útlevélkezelő API

  • DPP API (EN 18222)

    /openapi-dpp.json

    Életciklus- és finomszemcsés API az EN 18222 szabvány szerint: útlevelek olvasása a hozzáférési szintjén, útlevél-azonosítók keresése termékazonosító alapján, események (javítás, állapot, státusz) rögzítése OAuth 2.0 hozzáférési tokennel. A nyilvános adatok token nélkül olvashatók.

    Referencia: DPP API (EN 18222)

Útlevél olvasása

Minden útlevélcím JSON-nal válaszol, ha kéri – a nyilvános adatokhoz nem kell kulcs. A fejlécek hordozzák a verziót, annak SHA-256 értékét és az Ed25519 aláírást, így az olvasottakat ellenőrizheti nyilvános kulcsainkkal.

curl -i -H "Accept: application/json" \https://batterycompliance.eu/id/BG123456789/EBIKE-48V/SN0001 HTTP/1.1 200 OKContent-Type: application/json; charset=utf-8X-Passport-Version: 3X-Passport-Access-Level: publicX-Passport-SHA256: bd4c49c7b04ac463…81146b938X-Passport-Signature: Tw0bRkvf+s3IS1MQ…MPZ7Dg==X-Passport-Key-Id: batterycompliance-2026-09-25Link: </schema/battery-passport/2.0.0>; rel="describedby" { "dppHeader": { "dppStatus": { "dppStatusValue": "active" }, … },  "identifiersAndProductData": { "batterySerialNumber": "SN0001", … }, … }
A hosszú értékek le vannak rövidítve. Hozzáférési tokennel ugyanaz a cím az Ön hozzáférési szintjének mezőit adja vissza, és az X-Passport-Access-Level megnevezi azt.

Hogyan működnek az API-k

Hitelesítés

Az API-kulcsokat a cég tulajdonosa hozza létre a Cég → API-kulcsok oldalon, és egyszer jelennek meg. Küldje őket így: Authorization: Bearer bcp_live_…. Hatókörök: items:read, items:write (olvas is), items:publish, qr:read.

Az OAuth 2.0 klienseket (client credentials) a cég tulajdonosa hozza létre partnerei számára, a platform pedig a hatóságok és jóváhagyott harmadik felek számára. A tokent a POST /oauth/token hívással kapja (grant_type=client_credentials); 15 percig érvényes. Hatókörök: dpp:read, dpp:search, dpp:write.

Korlátok és hibák

API-kulcsonként percenként 60 kérés (fejlécek: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset), OAuth-kliensenként vagy token nélkül címenként percenként 120. A korlát felett: HTTP 429 Retry-After fejléccel.

Az útlevélkezelő API a hibákat error objektummal válaszolja meg, amely code, message és details mezőkből áll; a DPP API statusCode, payload és result mezőkkel az EN 18222 állapotkódjaival válaszol.

A DPP API frissítései elfogadnak egy Idempotency-Key fejlécet: ugyanaz a kulcs ugyanazzal a kéréssel 24 órán belül az első választ adja vissza, és nem hoz létre második verziót.

Nyilvános útlevelek

Minden útlevélnek állandó címe van (GS1 Digital Link /01/{GTIN}/21/{serial} vagy /id/{operator}/{model}/{serial}). Az Accept: application/json fejléccel vagy a ?format=json paraméterrel a legfrissebb verzió JSON-ját adja vissza az Ön hozzáférési szintjére; a ?version=N egy adott verziót; a /versions a listát.

Minden verzió aláírt: az X-Passport-SHA256 a teljes verzió RFC 8785 szerinti kanonikus JSON-jának SHA-256 értékét, az X-Passport-Signature az erre a hexadecimális sztringre készült Ed25519 aláírást, az X-Passport-Key-Id pedig az aláíró kulcsot hordozza. A nyilvános kulcsok és a séma a Gépileg olvasható leírások alatt találhatók.

Webhookok

A lekérdezés helyett adjon hozzá egy végpontot a Cég → Webhookok oldalon. Az események – passport.published, publish_job.finished, item.lifecycle_recorded, access_request.created, passport.transferred, label_template.issued, dossier.ready, import_batch.assigned, import_batch.confirmed, import_batch.rejected – JSON-ként érkeznek POST-tal az X-Webhook-Id, X-Webhook-Timestamp és X-Webhook-Signature fejlécekkel, ahol az utóbbi = v1= + a timestamp.body hexadecimális HMAC-SHA256 értéke az Ön titkos kulcsával. Válaszoljon 2xx-szel 10 másodpercen belül; a sikertelen kézbesítéseket 24 órán át ismételjük.

Gépileg olvasható leírások

Szerezzen API-kulcsot

Regisztrálja cégét, majd hozzon létre egy kulcsot a Cég → API-kulcsok oldalon. A kulcsok egyszer jelennek meg, és csak hash-ként tároljuk őket.

Kezdje ingyenBeszéljen velünk