文档

状态码

更新时间:

边缘端API的状态码如下表格所示。

HTTP状态码错误码(Code)描述
200 OK接口调用成功。
201 Created请求成功并且服务器创建了新的资源。
400 Bad RequestBadRequest语义有误,当前请求无法被服务器理解,除非进行修改,否则客户端不应该重复提交该请求。

详细的错误信息,请查看本文下方400 Bad Request状态码详细错误信息表格。

401 UnauthorizedUnauthorized目标资源的身份认证Cookie不正确,需要重新调用CreateAuthCookie接口更新Cookie,否则将无法继续调用其他API。
403 ForbiddenForbidden服务器已经理解请求,但拒绝执行请求。需要进行权限校验,确认当前登录用户是否有权限调用请求API。
404 Not FoundNotFound请求失败,未在服务器上发现请求所希望得到的资源。需要确认请求参数是否正确。
405 Method Not AllowedMethodNotAllowed请求行中指定的请求方法不能被用于请求相应的资源。例如,不支持使用POST方法。
500 Internal Server ErrorInternalServerError服务器内部错误。

详细的错误信息,请查看本文下方500 Internal Server Error状态码详细错误信息表格。

说明 出现500 Internal Server Error错误时,请优先根据错误信息提示和日志内容排查问题。
503 Service UnavailableServiceUnavailable

由于临时的服务器维护或服务器过载,因此服务器当前无法处理请求。

表 1. 400 Bad Request状态码详细错误信息
错误码(Code)描述
InvalidParameter请求参数有误。请输入正确的请求参数,然后重试。
MissingParameter缺少必要的请求参数。请输入正确的请求参数,然后重试。
表 2. 500 Internal Server Error状态码详细错误信息
错误码(Code)描述
Cookie.Handler.Create无法创建身份认证Cookie。
Cookie.Set无法保存身份认证Cookie。
HMAC认证消息的哈希算法(HMAC)运算失败。
Connection.Create无法与上游服务建立连接。
Connection.Lost与上游服务的连接已断开。
Message.Create无法创建发送到上游服务的消息。
Message.SendAndReply发送消息到上游服务,或接收上游服务消息异常。
Message.InvalidReply上游服务响应的格式不正确。
Message.FailedReply上游服务的响应结果显示,调用接口失败。

当上游服务返回的错误码(Code)不在本行下方Service.{name}.{error}格式的错误列表中时,会返回该错误码。

Service.NotExist上游服务不存在。通常上游服务未启动或者退出时,报此错误码。
Service.Data.Get无法从数据中心获取数据。
Service.Data.Set无法设置数据到数据中心。
Service.Data.KeyNotExist无法从数据中心获取数据,因为数据的key不存在。
Service.Thing.Call调用设备接口失败。详细说明,请参见设备接入状态码
Service.Function.NotExist被调函数不存在。
Service.Function.Timeout函数执行超时。
Service.Scene.NotExist场景规则不存在。
Service.Scene.NotAtLevel0禁止执行操作,因为场景联动的运行状态为非Normal模式,例如Sceneless模式等,请更换为Normal模式后重试。