TracePass
Inizia ora
Passaporti

Ottenere l'indirizzo EU DPP Registry di un passaporto della batteria

Restituisce l'identificatore unico del prodotto (UPI) da incollare nel modulo online dell'EU DPP Registry per un passaporto della **batteria** pubblicato, come `{ upi, preparedAt }`. L'operatore economico registra il passaporto sul sito web del registro con il proprio EU Login (Product group: Batteries; Granularity: Item). TracePass prepara l'indirizzo e annota di averlo fatto; non presenta mai nulla al registro.

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

Ottenere l'indirizzo EU DPP Registry di un passaporto della batteria

Restituisce l'identificatore unico del prodotto (UPI) da incollare nel modulo online dell'EU DPP Registry per un passaporto della **batteria** pubblicato, come `{ upi, preparedAt }`. L'operatore economico registra il passaporto sul sito web del registro con il proprio EU Login (Product group: Batteries; Granularity: Item). TracePass prepara l'indirizzo e annota di averlo fatto; non presenta mai nulla al registro.

**La prima chiamata congela l'indirizzo** nel passaporto come `registryUpi`, e le chiamate successive restituiscono lo stesso indirizzo. Il registro conserva l'URL ricevuto, quindi quell'URL deve continuare a risolversi anche se il dominio del vostro account cambia in seguito. Ogni chiamata annota la preparazione nel passaporto (`registrationPreparedAt`, `registrationPreparedVia: "form"`). Una preparazione non è una registrazione: quando il registro ha risposto, annotate la sua risposta con `POST /api/v1/passports/{id}/registration`.

I rifiuti rispondono **409** con un codice in `error`: `not_a_battery`, `not_published` (solo un passaporto pubblicato può essere registrato), `registered_in_production` (il passaporto è già registrato nel registro di produzione), `registry_not_ready` (il passaporto ha un risultato bloccante della verifica di prontezza per il registro; `findingDetails` elenca i risultati, prima quelli bloccanti, dalla stessa verifica di `GET /api/v1/passports/{id}/registry-readiness`) e `invalid_upi` (l'indirizzo non è un URL `https://` di al massimo 2000 caratteri).

**Solo piani a pagamento** (`402` su Free: un passaporto Free scade dopo 30 giorni). Le chiamate OAuth devono agire per un amministratore o un proprietario. Nessun corpo della richiesta. Conta come una scrittura v1, e solo quando la chiamata riesce. Rispetta `Idempotency-Key`.

Parametri di percorso

  • idobbligatorio

    string (24 hex chars)

    ID di un passaporto della batteria pubblicato.

Header

  • Authorizationobbligatorio

    string

    `Bearer <token>` — una chiave API `tp_` (Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

  • Idempotency-Key

    string

    UUID v4.

Richiesta

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"

Risposta

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

Endpoint correlati