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