更新时间:2023-04-07 GMT+08:00
分享

返回结果

请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。

状态码

请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。

状态码是一组从2xx(成功)到4xx或5xx(错误)的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码

对于使用OAuth 2.0的客户端鉴权模式获取用户access_token接口,如果调用后返回状态码为“200”,则表示请求成功。

响应消息头

对应请求消息头,响应同样也有消息头,如“Content-type”。

对于使用OAuth 2.0的client credentials鉴权模式获取用户Token接口,返回如图1所示的消息头。

图1 响应消息头

响应消息体

响应消息体通常以结构化格式返回,与响应消息头中Content-type对应,传递除响应消息头之外的内容。

对于使用OAuth 2.0的客户端鉴权模式获取用户access_token接口,返回如下消息体。其中“access_token”是需要获取的用户Token,取值以变量“XXX”表示。有了Token之后,您可以使用access_token认证调用其他API。

{
  "access_token": "XXX",
  "expires_in": 1800,
  "token_type": "Bearer"
}

当接口调用出错时,会返回错误码“400”及错误信息说明,错误响应的Body体格式如下所示。

{
    "error": "unauthorized_client",
    "error_description": "The client is not authorized to request a token using this method."
}

其中,error表示错误提示,error_description表示错误描述信息。

相关文档