/api/v1/access-grantsElencare 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.
Filtri: role, status (active, expired, revoked), passportId (autorizzazioni che coprono quel passaporto: a livello aziendale, il suo prodotto o il passaporto stesso) e productId (autorizzazioni aziendali e quelle limitate a quel prodotto). Passate il nextCursor della pagina precedente come cursor; nell'ultima pagina nextCursor è null.
Chi può chiamarlo. Una chiave API solo se il suo titolare ha attivato «May manage access grants» per quella chiave nella pagina Developer (disattivato per impostazione predefinita; altrimenti 403 access_grants_not_enabled). Un token OAuth richiede lo scope access_grants:read e il ruolo di editor o superiore.
Parametri di query
- role
string
Solo autorizzazioni di questo ruolo, ad es.
purchaser. - status
string (active | expired | revoked)
Solo autorizzazioni in questo stato.
- passportId
string (24 hex chars)
Solo autorizzazioni che coprono questo passaporto.
- productId
string (24 hex chars)
Solo autorizzazioni aziendali e quelle limitate a questo prodotto.
- limit
integer
Dimensione della pagina, da 1 a 100 (predefinito 50).
- cursor
string (24 hex chars)
Il
nextCursordella pagina precedente.
Header
- Authorizationobbligatorio
string
Bearer <token>— una chiave APItp_(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
Richiesta
curl -sS "https://app.tracepass.eu/api/v1/access-grants?status=active&role=purchaser" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Risposta
{
"data": [
{
"id": "6650c1d2e3f4a5b6c7d8e9f0",
"accessLevel": "restricted",
"label": "Buyer GmbH, order 4711",
"role": "purchaser",
"scope": { "kind": "passports", "ids": ["6650a1b2c3d4e5f6a7b8c9d0"] },
"purpose": null,
"evidence": null,
"state": "active",
"expiresAt": null,
"useCount": 0,
"createdAt": "2026-06-01T09:30:00.000Z"
}
],
"nextCursor": null
}