oauth.authorize

此接口为平台应用（APP）服务端实现，由SUD OpenPaaS服务端调用。

获取授权码。有效期5分钟，仅可单次使用，失效需重新发起授权。

调用方式：

• HTTPS 调用

HTTPS 调用

GET {authorize_webhook}

请求参数 - Query

属性	类型	默认值	必填	说明
client_id	string		是	平台分配给 SUD 的应用 ID
redirect_uri	string		是	授权成功后回调 SUD 地址，域名/路径/端口完全一致（大小写敏感），不允许携带query参数
response_type	string		是	固定值：code
state	string		否	防重放，随机字符串

返回值

Object

返回的 JSON 数据包

属性	类型	说明
ret_code	number	错误码：0 表示成功，非 0 表示失败
ret_msg	string	错误信息：成功返回 "ok"，失败返回具体错误原因
code	string	授权码（仅在成功时返回）
state	string	原样返回请求中的 state

errcode 的合法值

值	说明	最低版本
0	请求成功
40001	invalid client_id，检查 client_id 是否正确
40002	invalid redirect_uri，检查回调地址是否与后台配置一致
40003	invalid response_type，确认该字段固定值为 code

cURL 请求

curl -X GET \
  '{authorize_webhook}?client_id=YOUR_CLIENT_ID&redirect_uri=[https://your.domain.com/callback&response_type=code&state=RANDOM_STATE_STRING](https://your.domain.com/callback&response_type=code&state=RANDOM_STATE_STRING)'

成功返回

{
  "errcode": 0,
  "errmsg": "ok",
  "code": "AUTHORIZATION_CODE",
  "state": "RANDOM_STATE_STRING"
}

错误返回

{
  "errcode": 40001,
  "errmsg": "invalid client_id"
}