TracePass
Autorizzazioni di accesso

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
Scarica OpenAPI 3.1
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.

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 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?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
}