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

curl -X POST 'https://api.sofia-post.com/api/v1/oauth/token' \
  -H 'Content-Type: application/json' \
  -d '{"grant_type":"authorization_code","client_id":"sofia_app_test_3oG2kW0Qm8bX1yZa","scope":"posts:write","workspace_id":"ws_3oG2kW0Qm8bX1yZa"}'

{
  "access_token": "sofia_test_at_kq3V0yJ8x1…",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "posts:read posts:write",
  "refresh_token": "sofia_live_rt_Zk2…"
}

Emettere un token di accesso

curl --request POST \
  --url 'https://api.sofia-post.com/api/v1/oauth/token' \
  --header 'Content-Type: application/json' \
  --data '{
  "grant_type": "authorization_code",
  "client_id": "sofia_app_test_3oG2kW0Qm8bX1yZa",
  "scope": "posts:write",
  "workspace_id": "ws_3oG2kW0Qm8bX1yZa"
}'

{
  "access_token": "sofia_test_at_kq3V0yJ8x1…",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "posts:read posts:write",
  "refresh_token": "sofia_live_rt_Zk2…"
}

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

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

Questa pagina ti è stata utile?