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

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

详细的错误信息,请查看本文下方表 1表格。

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

详细的错误信息,请查看本文下方表 2表格。

说明 出现500 Internal Server Error错误时,请优先根据错误信息提示和日志内容排查问题,若仍无法解决问题,您可以提交工单联系我们获取技术支持。
503 Service Unavailable ServiceUnavailable

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

表 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模式后重试。