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