TracePass
Autorizzazioni di accesso

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.

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

Spostare in avanti la scadenza di un'autorizzazione scaduta la rende di nuovo attiva e vale il limite di 50 autorizzazioni attive come alla creazione. Un'autorizzazione revocata risponde 404. La modifica è scritta nel registro degli accessi con la chiave API o l'app che l'ha fatta.

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:write e un utente admin o owner. Richiede un account a pagamento. Conta come una scrittura v1. Rispetta Idempotency-Key.

Parametri di percorso

  • idobbligatorio

    string (24 hex chars)

    ID dell'autorizzazione di accesso.

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

  • Idempotency-Key

    string

    UUID v4.

Campi del corpo

  • label

    string (1-120 chars)

    Nuova etichetta.

  • purpose

    string (max 500 chars)

    Nuovo scopo.

  • scope

    object

    Nuovo ambito, stessa forma della creazione. Un'autorizzazione da acquirente deve restare sui passaporti.

  • evidence

    object

    Nuova prova { type, reference, note? }.

  • expiresInDays

    integer | null (1-1825)

    Giorni da ora alla scadenza; null = nessuna scadenza.

Richiesta

curl -sS -X PATCH https://app.tracepass.eu/api/v1/access-grants/6650c1d2e3f4a5b6c7d8e9f0 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "expiresInDays": 90 }'

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