TracePass
Riferimento

Autorizzazioni di accesso

Condividete dati riservati del passaporto con acquirenti o riciclatori e revocateli: creare, elencare, modificare, revocare e registro accessi.

POST/api/v1/access-grants

Creare un'autorizzazione di accesso

Date a un destinatario accesso alla parte riservata dei vostri passaporti, con le stesse regole della dashboard: il ruolo decide quali punti dati mostra l'autorizzazione, un'autorizzazione da acquirente indica i passaporti che copre e termina quando la batteria cambia proprietario, e un'azienda ha al massimo 50 autorizzazioni attive.

GET/api/v1/access-grants

Elencare le autorizzazioni di accesso

Le autorizzazioni di accesso dell'azienda, le più recenti per prime, con cursore. Un'autorizzazione è la credenziale con cui un destinatario (un acquirente, un riparatore, un riciclatore) legge la parte riservata di un passaporto. L'elenco non restituisce mai un token, né una parte di esso.

GET/api/v1/access-grants/{id}

Leggere un'autorizzazione di accesso

Un'autorizzazione della vostra azienda, attiva, scaduta o revocata. Il campo `state` indica quale. La risposta non contiene mai il token né una parte di esso.

PATCH/api/v1/access-grants/{id}

Modificare un'autorizzazione di accesso

Modifica etichetta, scopo, prova, scadenza o ambito di un'autorizzazione attiva. Inviate solo le chiavi da cambiare, almeno una. Il ruolo non può essere cambiato: revocate l'autorizzazione e createne una nuova. Un'autorizzazione di un'autorità (ruolo di autorità o livello authority) si può modificare solo nella dashboard: tramite API risponde `400 role_dashboard_only`.

DELETE/api/v1/access-grants/{id}

Revocare un'autorizzazione di accesso

Revoca un'autorizzazione: il suo token smette di funzionare subito. Idempotente: revocare un'autorizzazione già revocata risponde di nuovo `200` con essa. Solo un id che non è della vostra azienda risponde `404`. Un'autorizzazione di un'autorità (ruolo di autorità o livello authority) si può revocare solo nella dashboard: tramite API risponde `400 role_dashboard_only`.

GET/api/v1/access-grants/{id}/activity

Registro degli accessi di un'autorizzazione

Le righe di registro dell'autorizzazione, le più recenti per prime, con cursore. Gli eventi (`grant_created`, `grant_changed`, `grant_revoked`) indicano chi ha agito: `via` è la chiave API (con la sua etichetta) o l'app OAuth ed è `null` per la dashboard; `actorId` è l'utente per cui si è agito. Le righe `read` portano un conteggio per passaporto, canale e giorno.