Skip to content

oauth.authorize ​

此接口为平台应用(APP)服务端实现,由SUD OpenPaaS服务端调用。

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

调用方式:

  • HTTPS 调用

HTTPS 调用 ​

http
GET {authorize_webhook}

请求参数 - Query ​

属性类型默认值必填说明
client_idstring是平台分配给 SUD 的应用 ID
redirect_uristring是授权成功后回调 SUD 地址,域名/路径/端口完全一致(大小写敏感),不允许携带query参数
response_typestring是固定值:code
statestring否防重放,随机字符串

返回值 ​

Object ​

返回的 JSON 数据包

注:本接口的 code 和 state 直接位于响应顶层,不使用 data 包裹,与其他接口的响应结构不同。

属性类型说明
ret_codeinteger错误码:0 表示成功,非 0 表示失败
ret_msgstring错误信息:成功返回 "success",失败返回具体错误原因
codestring授权码(仅在成功时返回)
statestring原样返回请求中的 state

ret_code 的合法值 ​

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

cURL 请求 ​

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

成功返回 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "code": "AUTHORIZATION_CODE",
  "state": "RANDOM_STATE_STRING"
}

错误返回 ​

json
{
  "ret_code": 40001,
  "ret_msg": "invalid client_id"
}