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必須

    要求するスコープ。スペース区切りです（リフレッシュトークンには offline_access）。

  • statestring

    戻る際にそのまま返され、クライアントを CSRF から守ります。

  • code_challengestring必須

    PKCE チャレンジ base64url(SHA-256(code_verifier))。すべてのクライアントで必須です。

  • code_challenge_methodstring必須

    S256 を指定します。

レスポンス

302

同意画面へリダイレクトするか、エラーを redirect_uri に返します。

400

invalid_client：未知のクライアント、または未登録の redirect_uri。