返回结果
请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。
状态码
状态码是一组从2xx(成功)到4xx或5xx(错误)的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。
对于使用OAuth 2.0的客户端鉴权模式,获取的用户access_token接口,如果调用后返回状态码为“200”,则表示请求成功。
响应消息头
对应请求消息头,响应同样也有消息头,如“Content-type”。
对于使用OAuth 2.0的client credentials鉴权模式,获取的用户Token接口,返回如下所示的消息头。
响应消息体(可选)
响应消息体通常以结构化格式(如JSON或XML)返回,与响应消息头中Content-type对应,传递除响应消息头之外的内容。
对于使用OAuth 2.0的客户端鉴权模式,获取的用户access_token接口,返回如下消息体。其中,“access_token”是需要获取的用户Token,取值以变量“XXX”表示。有了Token之后,您可以使用access_token认证调用其他API。
{ "access_token": "XXX", "expires_in": 600, "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表示错误描述信息。