/api/v1/access-grants/{id}/activityRegistro 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.
Non vengono conservati indirizzi IP e le righe sono eliminate dopo 24 mesi. L'id di un'altra azienda risponde 404.
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 percorso
- idobbligatorio
string (24 hex chars)
ID dell'autorizzazione di accesso.
Parametri di query
- 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/6650c1d2e3f4a5b6c7d8e9f0/activity \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Risposta
{
"data": [
{
"id": "6650d2e3f4a5b6c7d8e9f0a1",
"kind": "grant_created",
"day": "2026-06-01T00:00:00.000Z",
"channel": null,
"passportId": null,
"count": null,
"detail": null,
"actorId": "6650a0a0a0a0a0a0a0a0a0a0",
"via": { "kind": "api_key", "keyId": "6650b0b0b0b0b0b0b0b0b0b0", "label": "SAP prod" },
"lastAt": "2026-06-01T09:30:00.000Z"
}
],
"nextCursor": null
}