错误处理

对此规范中定义的所有错误使用 400 Bad Request 状态代码。对于所有其他错误,制造商应使用 4XX 范围内的错误表示客户端错误,使用 5XX 范围内的错误表示服务器错误。对于所有错误情况,响应都应始终包含以下格式的 JSON 正文:

{
    "name": "camera.info",
    "state": "error",
    "error": {
        "code": "serverError",
        "message": "cannot get camera info."
    }
}
  • name 可以是 camera.infocamera.statecamera.checkForUpdatescamera.commands.statuscamera.commandName
  • 对于 400 状态代码,code 应为以下值之一:unknownCommandcameraInExclusiveUsemissingParameterinvalidParameterNameinvalidParameterValue
  • message 由制造商定义,不会进行本地化 消息。