TracePass
Autorizzazioni di accesso

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.

GET/api/v1/access-grants/{id}/activity
Scarica OpenAPI 3.1
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.

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 nextCursor della pagina precedente.

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

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
}