TracePass
Loslegen
Pässe

Adresse eines Batteriepasses für das EU DPP Registry abrufen

Liefert die eindeutige Produktkennung (UPI), die in das Online-Formular des EU DPP Registry eingefügt wird, für einen veröffentlichten Batteriepass, als { upi, preparedAt }. Der Wirtschaftsakteur registriert den Pass auf der Website des Registry mit seinem eigenen EU Login (Product group: Batteries; Granularity: Item). TracePass bereitet die Adresse vor und hält fest, dass es das getan hat; es reicht nie etwas beim Registry ein.

POST/api/v1/passports/{id}/registry-upi
OpenAPI 3.1 herunterladen
POST/api/v1/passports/{id}/registry-upi

Adresse eines Batteriepasses für das EU DPP Registry abrufen

Liefert die eindeutige Produktkennung (UPI), die in das Online-Formular des EU DPP Registry eingefügt wird, für einen veröffentlichten Batteriepass, als { upi, preparedAt }. Der Wirtschaftsakteur registriert den Pass auf der Website des Registry mit seinem eigenen EU Login (Product group: Batteries; Granularity: Item). TracePass bereitet die Adresse vor und hält fest, dass es das getan hat; es reicht nie etwas beim Registry ein.

Der erste Aufruf friert die Adresse im Pass als registryUpi ein, spätere Aufrufe liefern dieselbe Adresse. Das Registry behält die URL, die es erhalten hat, daher muss diese URL weiter auflösen, auch wenn sich die Domain Ihres Kontos später ändert. Jeder Aufruf hält die Vorbereitung im Pass fest (registrationPreparedAt, registrationPreparedVia: "form"). Eine Vorbereitung ist keine Registrierung: Sobald das Registry geantwortet hat, erfassen Sie seine Antwort mit POST /api/v1/passports/{id}/registration.

Ablehnungen antworten mit 409 und einem Code in error: not_a_battery, not_published (nur ein veröffentlichter Pass kann registriert werden), registered_in_production (der Pass ist bereits im Produktiv-Registry registriert), registry_not_ready (der Pass hat einen blockierenden Befund der Registry-Bereitschaftsprüfung; findingDetails listet die Befunde auf, blockierende zuerst, aus derselben Prüfung wie GET /api/v1/passports/{id}/registry-readiness) und invalid_upi (die Adresse ist keine https://-URL mit höchstens 2000 Zeichen).

Nur in Bezahlplänen (402 auf Free: Ein Free-Pass läuft nach 30 Tagen ab). OAuth-Aufrufer müssen für einen Admin oder Owner handeln. Kein Request-Body. Zählt als ein v1-Schreibvorgang, und nur, wenn der Aufruf gelingt. Unterstützt Idempotency-Key.

Pfad-Parameter

  • iderforderlich

    string (24 hex chars)

    Pass-ID eines veröffentlichten Batteriepasses.

Header

  • Authorizationerforderlich

    string

    Bearer <token> — entweder ein tp_ API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

  • Idempotency-Key

    string

    UUID v4.

Anfrage

curl -sS -X POST \
  https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/registry-upi \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -H "Idempotency-Key: 7c2e4a91-3d5b-4f8e-a6c0-1b9d2e4f6a80"

Antwort

{
  "upi": "https://id.tracepass.eu/01/04012345000016/21/A1B2C3",
  "preparedAt": "2026-11-06T10:00:00.000Z"
}

Verwandte Endpoints