Μετάβαση στο κύριο περιεχόμενο
Battery Compliance
Ξεκινήστε δωρεάν
Μενού

Προγραμματιστές

Συνδέστε το ERP ή τα συστήματα παραγωγής σας: δημιουργήστε και δημοσιεύστε διαβατήρια μπαταρίας, διαβάστε και ενημερώστε τα μέσω API DPP που ακολουθεί το EN 18222 και λάβετε συμβάντα μέσω webhook. Η πρόσβαση στο API περιλαμβάνεται σε κάθε πρόγραμμα, και στο Free.

Δύο API

  • API διαχείρισης διαβατηρίων

    /openapi.json

    Για την εταιρεία που κατέχει τα διαβατήρια: λίστα μοντέλων και τεμαχίων (με δείκτη, με updatedSince για συγχρονισμό), δημιουργία τεμαχίων, ακολουθιών και αντιγράφων μοντέλων, ενημέρωση δεδομένων τεμαχίου, δημοσίευση (ενός τεμαχίου ή στο παρασκήνιο) και λήψη κωδικών QR. Έλεγχος ταυτότητας με κλειδί API.

    Αναφορά: API διαχείρισης διαβατηρίων

  • API DPP (EN 18222)

    /openapi-dpp.json

    API Life Cycle και Fine Granular σύμφωνο με το EN 18222: ανάγνωση διαβατηρίων στο επίπεδο πρόσβασής σας, αναζήτηση αναγνωριστικών διαβατηρίων με βάση το αναγνωριστικό προϊόντος, καταγραφή συμβάντων (επισκευή, κατάσταση υγείας, κατάσταση) με διακριτικό πρόσβασης OAuth 2.0. Τα δημόσια δεδομένα μπορούν να διαβαστούν χωρίς διακριτικό.

    Αναφορά: API DPP (EN 18222)

Ανάγνωση διαβατηρίου

Κάθε διεύθυνση διαβατηρίου απαντά με JSON όταν το ζητήσετε – δεν χρειάζεται κλειδί για δημόσια δεδομένα. Οι κεφαλίδες φέρουν την έκδοση, το SHA-256 της και την υπογραφή Ed25519, ώστε να ελέγξετε όσα διαβάσατε με τα δημόσια κλειδιά μας.

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", … }, … }
Οι μακριές τιμές συντομεύονται. Με διακριτικό πρόσβασης η ίδια διεύθυνση επιστρέφει τα πεδία του επιπέδου πρόσβασής σας και η X-Passport-Access-Level το αναφέρει.

Πώς λειτουργούν τα API

Έλεγχος ταυτότητας

Τα κλειδιά API δημιουργούνται από τον ιδιοκτήτη της εταιρείας στο Company → API keys και εμφανίζονται μία φορά. Στείλτε τα ως Authorization: Bearer bcp_live_…. Εμβέλειες: items:read, items:write (επιτρέπει και ανάγνωση), items:publish, qr:read.

Οι πελάτες OAuth 2.0 (client credentials) δημιουργούνται από τον ιδιοκτήτη της εταιρείας για τους συνεργάτες του ή από την πλατφόρμα για αρχές και εγκεκριμένους τρίτους. Λάβετε διακριτικό με POST /oauth/token (grant_type=client_credentials)· ισχύει για 15 λεπτά. Εμβέλειες: dpp:read, dpp:search, dpp:write.

Όρια και σφάλματα

60 αιτήματα ανά λεπτό ανά κλειδί API (κεφαλίδες X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) και 120 ανά λεπτό ανά πελάτη OAuth ή, χωρίς διακριτικό, ανά διεύθυνση. Σε υπέρβαση του ορίου: HTTP 429 με Retry-After.

Το API διαχείρισης διαβατηρίων απαντά στα σφάλματα με αντικείμενο error με code, message και details· το API DPP απαντά με statusCode, payload και result με τους κωδικούς κατάστασης του EN 18222.

Οι ενημερώσεις του API DPP δέχονται κεφαλίδα Idempotency-Key: το ίδιο κλειδί με το ίδιο αίτημα εντός 24 ωρών επιστρέφει την πρώτη απάντηση και δεν δημιουργεί δεύτερη έκδοση.

Δημόσια διαβατήρια

Κάθε διαβατήριο έχει μόνιμη διεύθυνση (GS1 Digital Link /01/{GTIN}/21/{serial} ή /id/{operator}/{model}/{serial}). Με Accept: application/json ή ?format=json επιστρέφει το JSON της τελευταίας έκδοσης για το επίπεδο πρόσβασής σας· με ?version=N μια συγκεκριμένη έκδοση· με /versions τη λίστα.

Κάθε έκδοση είναι υπογεγραμμένη: η X-Passport-SHA256 φέρει το SHA-256 του κανονικοποιημένου JSON RFC 8785 ολόκληρης της έκδοσης, η X-Passport-Signature την υπογραφή Ed25519 πάνω σε αυτή την εξαψήφια αναπαράσταση και η X-Passport-Key-Id το κλειδί που υπέγραψε. Τα δημόσια κλειδιά και το σχήμα παρατίθενται στις Περιγραφές αναγνώσιμες από μηχανή.

Webhooks

Αντί να ρωτάτε συνεχώς, προσθέστε ένα τελικό σημείο στο Company → Webhooks. Τα συμβάντα – 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 – αποστέλλονται με POST ως JSON με τις κεφαλίδες X-Webhook-Id, X-Webhook-Timestamp και X-Webhook-Signature = v1= + δεκαεξαδικό HMAC-SHA256 του timestamp.body με το μυστικό σας. Απαντήστε 2xx εντός 10 δευτερολέπτων· οι αποτυχημένες παραδόσεις επαναλαμβάνονται επί 24 ώρες.

Περιγραφές αναγνώσιμες από μηχανή

Αποκτήστε κλειδί API

Καταχωρίστε την εταιρεία σας και έπειτα δημιουργήστε κλειδί στο Company → API keys. Τα κλειδιά εμφανίζονται μία φορά και αποθηκεύονται μόνο ως κατακερματισμένη τιμή (hash).

Ξεκινήστε δωρεάνΜιλήστε μαζί μας