Emitir un token de acceso

Canjea client_credentials, un authorization_code con PKCE o un refresh_token de un solo uso por un token opaco de 3600 s para un Workspace.

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

Cuerpo

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

grant_typestringobligatorio
El grant a canjear: client_credentials, authorization_code o refresh_token
Valores permitidos: client_credentialsauthorization_coderefresh_token
client_idstringobligatorio
Identificador de la aplicación cliente
client_secretstring
Secreto de un cliente confidencial (client_secret_post), o en la cabecera Authorization: Basic (client_secret_basic), nunca ambos; ninguno para un cliente público
scopestring
Permisos solicitados, separados por un espacio; ausente: todos los del grant
workspace_idstring
El Workspace en el que actúa el token: obligatorio cuando la aplicación tiene varios con client_credentials, opcional cuando solo tiene uno
codestring
authorization_code: el código recibido en la dirección de redirección
code_verifierstring
authorization_code: el verificador PKCE (RFC 7636)
redirect_uristring
authorization_code: la misma dirección de redirección que en la autorización
refresh_tokenstring
refresh_token: el refresh token, de un solo uso

Respuesta

200application/json

El token de acceso, con un refresh_token solo si se concedió offline_access.

access_tokenstringobligatorio
El token de acceso opaco
token_typestringobligatorio
Siempre Bearer
Valores permitidos: Bearer
expires_innumberobligatorio
Validez en segundos
scopestringobligatorio
Los permisos concedidos, separados por un espacio
refresh_tokenstring
Solo authorization_code y refresh_token, cuando se concedió offline_access: de un solo uso, rota en cada canje

400

invalid_request, invalid_grant, unsupported_grant_type, invalid_scope o unauthorized_client.

401

invalid_client: cliente desconocido, secreto incorrecto o ausente, o aplicación revocada.

Emitir un token de acceso

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