OAuthEmettere un token di accesso
Torna a Sofia

OAuth

Emettere un token di accesso

Scambia client_credentials, un authorization_code con PKCE o un refresh_token monouso con un token opaco di 3600 s per un Workspace.

POSThttps://api.sofia-post.com/api/v1/oauth/token

Body

application/x-www-form-urlencoded, application/json

  • grant_typestringobbligatorio

    Il grant da scambiare: client_credentials, authorization_code o refresh_token

    Valori ammessi: client_credentialsauthorization_coderefresh_token

  • client_idstringobbligatorio

    Identificatore dell'applicazione client

  • client_secretstring

    Secret di un client confidenziale (client_secret_post), o nell'header Authorization: Basic (client_secret_basic), mai entrambi; nessuno per un client pubblico

  • scopestring

    Permessi richiesti, separati da uno spazio; assente: tutti quelli del grant

  • workspace_idstring

    Il Workspace su cui agisce il token: obbligatorio quando l'applicazione ne ha più di uno con client_credentials, facoltativo quando ne ha uno

  • codestring

    authorization_code: il codice ricevuto all'indirizzo di reindirizzamento

  • code_verifierstring

    authorization_code: il verifier PKCE (RFC 7636)

  • redirect_uristring

    authorization_code: lo stesso indirizzo di reindirizzamento dell'autorizzazione

  • refresh_tokenstring

    refresh_token: il refresh token, monouso

Risposta

200application/json

Il token di accesso, con un refresh_token solo se è stato concesso offline_access.

  • access_tokenstringobbligatorio

    Il token di accesso opaco

  • token_typestringobbligatorio

    Sempre Bearer

    Valori ammessi: Bearer

  • expires_innumberobbligatorio

    Validità in secondi

  • scopestringobbligatorio

    I permessi concessi, separati da uno spazio

  • refresh_tokenstring

    Solo authorization_code e refresh_token, quando è stato concesso offline_access: monouso, ruota a ogni scambio

400

invalid_request, invalid_grant, unsupported_grant_type, invalid_scope o unauthorized_client.

401

invalid_client: client sconosciuto, secret errato o mancante, o applicazione revocata.