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。