Error handling

Use the 400 Bad Request status code for all errors defined in this specification. For all other errors, manufacturers should use errors in the 4XX range for client errors, and the 5XX range for server errors. The response should always include a JSON body in the following format for all error cases:

{
    "name": "camera.info",
    "state": "error",
    "error": {
        "code": "serverError",
        "message": "cannot get camera info."
    }
}
  • name can be any of camera.info, camera.state, camera.checkForUpdates, camera.commands.status, and camera.commandName.
  • code should be one of the following for 400 status code:unknownCommand, cameraInExclusiveUse, missingParameter, invalidParameterName, or invalidParameterValue.
  • message is defined by manufacturers and is not expected to be a localized message.