TracePass
Riferimento

Dati del passaporto ad accesso limitato

Come un partner o un'autorità legge i campi ad accesso limitato con un'autorizzazione di accesso (token pa_): ?access= o Bearer, filtro per ruolo, cache.

Un passaporto pubblicato mostra a tutti i suoi campi pubblici. Gli altri campi sono riservati alle parti che ne hanno bisogno: un riparatore, un riciclatore, un acquirente, un'autorità di vigilanza del mercato. L'operatore dà a tale parte un'autorizzazione di accesso, un token pa_, e la parte lo presenta quando legge il passaporto. Questa pagina spiega cosa invia il titolare e cosa torna indietro.

Leggere un passaporto con un'autorizzazione

Inviate l'autorizzazione all'indirizzo del passaporto, quello a cui punta il codice QR, in uno di due modi: come Authorization: Bearer pa_… o come parametro di query ?access=pa_…. L'intestazione Bearer è adatta ai programmi, il parametro a un link, ma un URL finisce nella cronologia del browser e nei log del server, quindi preferite l'intestazione quando potete. L'autorizzazione vale per la pagina del passaporto e per le viste JSON-LD, PDF, EPCIS e dati.

bash
curl -H "Authorization: Bearer pa_REDACTED_xxxxxxxxxxxx" \
  -H "Accept: application/ld+json" \
  https://id.tracepass.eu/01/99999999999997/21/6B27A0000001

La stessa richiesta con il parametro di query:

text
https://id.tracepass.eu/01/99999999999997/21/6B27A0000001?access=pa_REDACTED_xxxxxxxxxxxx

Un token pa_ serve a leggere un passaporto pubblicato. Non autentica le chiamate a /api/v1, che richiedono una chiave API tp_ o OAuth. Un'autorizzazione sconosciuta, scaduta, revocata o che non copre questo passaporto non viene rifiutata: la richiesta riceve la vista pubblica, come se non fosse stata inviata alcuna autorizzazione.

Cosa permette di vedere l'autorizzazione

L'operatore rilascia ogni autorizzazione a un ruolo indicato: riparatore, rifabbricatore, operatore di riconversione, riciclatore, trattamento dei rifiuti, centro di formazione, acquirente o suo incaricato, impianto di trattamento dei veicoli fuori uso o dei RAEE, vigilanza del mercato, organismo notificato, Commissione, dogana o altro. Ha come ambito l'intera azienda, prodotti scelti o passaporti scelti. I ruoli delle autorità vedono tutto il loro livello.

Per le batterie, il ruolo decide quali dati dell'allegato XIII vede il titolare: un riparatore vede i dati sui pezzi di ricambio e sullo smontaggio, un acquirente i dati della batteria che ha comprato, e così via. La corrispondenza segue il progetto di atto di esecuzione della Commissione ai sensi dell'articolo 77, paragrafo 9 del Regolamento batterie. Quell'atto non è adottato e il progetto può cambiare: la corrispondenza va considerata provvisoria.

Un campo che il ruolo non copre non viene omesso in silenzio. La vista del passaporto lo mostra come «Non incluso in questa autorizzazione di accesso» (nella lingua della vista), così il titolare distingue un campo nascosto dall'autorizzazione da un campo che il passaporto non contiene. I dati fuori dai campi, come la filiera, lo storico degli interventi e gli eventi EPCIS, seguono la stessa regola.

Durata e registro delle letture

Un'autorizzazione scade per impostazione predefinita dopo 12 mesi. Quella di un acquirente non ha scadenza e termina quando viene registrato un cambio di proprietario della batteria. L'operatore può revocare qualsiasi autorizzazione in qualsiasi momento. Al rilascio si registrano lo scopo e le prove che l'operatore ha verificato. Tali prove sono registrate, non verificate: TracePass non controlla l'identità del titolare.

Ogni lettura che serve contenuto tramite un'autorizzazione viene registrata e conteggiata per autorizzazione, passaporto, canale (pagina, JSON-LD, PDF, EPCIS, dati) e giorno. Il registro non contiene indirizzi IP.

Cache

Una risposta a un'autorizzazione è Cache-Control: private, no-store con Vary: Authorization. Non memorizzatela in una cache condivisa e non inoltratela: contiene dati che la vista pubblica non contiene.