返回结果

状态码

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

状态码是一组从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表示错误描述信息。