错误处理

对此规范中定义的所有错误使用 400 Bad Request 状态代码。 对于所有其他错误，如果是客户端错误，制造商应使用 4XX 的错误代码，如果是服务器错误，则使用 5XX 的错误代码。 对于所有错误案例，响应应始终包含一个采用以下格式的 JSON 正文：

{
    "name": "camera.info",
    "state": "error",
    "error": {
        "code": "serverError",
        "message": "cannot get camera info."
    }
}

  • name 可以是 camera.info、camera.state、camera.checkForUpdates、camera.commands.status 和 camera.commandName 中的任何一个。

  • 对于 400 状态代码，code 应该为下列中的一个：unknownCommand、cameraInExclusiveUse、missingParameter、invalidParameterName 或 invalidParameterValue。

  • message 由制造商定义，且预计不会进行本地化的消息。