OAuthTerbitkan access token
Kembali ke Sofia

OAuth

Terbitkan access token

Menukar client_credentials, authorization_code dengan PKCE, atau refresh_token sekali pakai dengan token buram berlaku 3600 detik untuk satu Workspace.

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

Body

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

  • grant_typestringwajib

    Grant yang ditukar: client_credentials, authorization_code, atau refresh_token

    Nilai yang diizinkan: client_credentialsauthorization_coderefresh_token

  • client_idstringwajib

    Pengenal aplikasi klien

  • client_secretstring

    Secret klien rahasia (client_secret_post), atau di header Authorization: Basic (client_secret_basic), tidak keduanya; kosong untuk klien publik

  • scopestring

    Scope yang diminta, dipisahkan spasi; tidak diisi: semua scope grant

  • workspace_idstring

    Workspace tempat token bertindak: wajib bila aplikasi memiliki beberapa di bawah client_credentials, opsional bila hanya satu

  • codestring

    authorization_code: kode yang diterima di alamat pengalihan

  • code_verifierstring

    authorization_code: verifier PKCE (RFC 7636)

  • redirect_uristring

    authorization_code: alamat pengalihan yang sama seperti saat otorisasi

  • refresh_tokenstring

    refresh_token: refresh token, sekali pakai

Respons

200application/json

Access token, dengan refresh_token hanya jika offline_access diberikan.

  • access_tokenstringwajib

    Access token buram

  • token_typestringwajib

    Selalu Bearer

    Nilai yang diizinkan: Bearer

  • expires_innumberwajib

    Masa berlaku dalam detik

  • scopestringwajib

    Scope yang diberikan, dipisahkan spasi

  • refresh_tokenstring

    Hanya authorization_code dan refresh_token, bila offline_access diberikan: sekali pakai, berganti setiap penukaran

400

invalid_request, invalid_grant, unsupported_grant_type, invalid_scope, atau unauthorized_client.

401

invalid_client: klien tidak dikenal, secret salah atau hilang, atau aplikasi dicabut.