OAuth發起授權
返回 Sofia

OAuth

發起授權

在使用者的瀏覽器中打開。未知用戶端或未註冊的 redirect_uri 回傳 400，否則重新導向至 Sofia 授權頁面。

GEThttps://api.sofia-post.com/api/v1/oauth/authorize

查詢參數

  • response_typestring必填

    必須為 code。

  • client_idstring必填

    用戶端的 client_id。

  • redirect_uristring必填

    已註冊的重新導向位址，需完全匹配。

  • scopestring必填

    申請的 scope，以空格分隔（offline_access 用於取得更新權杖）。

  • statestring

    回傳時原樣帶回，用於保護用戶端免受 CSRF 攻擊。

  • code_challengestring必填

    PKCE 挑戰，即 base64url(SHA-256(code_verifier))，所有用戶端都必須提供。

  • code_challenge_methodstring必填

    必須為 S256。

回應

302

重新導向到授權頁面，或把錯誤回傳到 redirect_uri。

400

invalid_client：未知用戶端或未註冊的 redirect_uri。