错误处理

对此规范中定义的所有错误使用 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 由制造商定义,且预计不会进行本地化的消息。