返回结果
请求发送以后,您会收到响应,包含:状态码、响应消息头和响应消息体。
状态码
状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,物联网平台返回的状态码如下所示。
对于鉴权接口,如果调用后返回状态码为“200”,则表示请求成功。
状态码 |
编码 |
状态码说明 |
---|---|---|
200 |
OK |
请求成功。 |
201 |
Created |
请求实现。 |
202 |
Accepted |
接受请求。 |
204 |
No Content |
无内容。 |
400 |
Bad Request |
请求错误。 |
401 |
Unauthorized |
鉴权失败。 |
403 |
Forbidden |
没有操作权限。 |
404 |
Not Found |
找不到资源。 |
409 |
Conflict |
请求冲突。 |
500 |
Internal Server Error |
服务内部错误。 |
503 |
Service Unavailable |
服务不可用。 |
响应消息头
对应请求消息头,响应同样也有消息头,如Content-Type。
参数 |
是否必选 |
说明 |
---|---|---|
Content-Type |
必选 |
消息体的媒体类型,默认取值为“application/json; charset=UTF-8”。 |
响应消息体
响应消息体通常以结构化格式返回,与响应消息头中Content-Type对应,传递除响应消息头之外的内容。
对于鉴权接口,返回如下消息体。
{ "scope": "default", "tokenType": "Bearer ", "expiresIn": 3600, "accessToken": "abcde*****", "refreshToken": "ABCDE*****" }
当接口调用出错时,会返回错误码及错误信息说明,错误响应的Body体格式如下所示。
{ "error_code": "100208", "error_desc": "AppId or secret is not right." }
其中,error_code表示错误码,error_desc表示错误描述信息,具体请查看每个接口的错误码信息。