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

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

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

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 服务器内部错误。

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

说明 出现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模式后重试。