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

返回结果

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

状态码

状态码是一组从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表示错误描述信息,具体请查看每个接口的错误码信息。

相关文档