Utilizzo di un token di accesso

Un token di accesso autorizza le richieste all'API di Altium 365. Includilo in ogni richiesta come token bearer nell'header Authorization.

I token di accesso possono essere ottenuti in due modi:

• Directly – creando un token di accesso a lunga durata in Admin → Developer

• Via exchange – utilizzando un token di aggiornamento per generare un token di accesso a breve durata (che non sarà elencato in Admin → Developer)

Il metodo di autorizzazione è lo stesso, indipendentemente da come è stato ottenuto il token.

Header di autorizzazione

Authorization: Bearer {access-token}

Esempio: curl

curl -X POST https://{workspace-domain}/api/graphql/ \
  -H "Authorization: Bearer {access-token}" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ desProjects(first: 5) { nodes { id name } } }"}'

Scadenza del token

Long-lived access tokens scadono al termine della durata configurata al momento della creazione (fino a 1 anno). Una volta scaduti, dovrai creare un nuovo token in Admin → Developer.

Short-lived access tokens (ottenuti tramite lo scambio di un token di aggiornamento) scadono dopo un breve periodo. Quando ciò accade, scambia nuovamente il token di aggiornamento per ottenerne uno nuovo: vedi Utilizzo di un token di aggiornamento.

Un token scaduto fa sì che le richieste API restituiscano 401 Unauthorized, oppure 200 OK con il codice di errore AuthExpiredToken nella risposta GraphQL.

Sicurezza

• Non incorporare token di accesso nel codice lato client e non inserirli nel sistema di controllo del codice sorgente.

• Per le integrazioni automatizzate a lunga esecuzione, preferisci l'approccio basato sul token di aggiornamento: i token di accesso a breve durata limitano la finestra di esposizione nel caso in cui un token venga compromesso.

Vedi anche

• Utilizzo di un token di aggiornamento