Gestione degli errori

Utilizza il codice di stato 400 Bad Request per tutti gli errori definiti in questa specifica. Per tutti gli altri errori, i produttori devono utilizzare gli errori nell'intervallo 4XX per gli errori del client e nell'intervallo 5XX per gli errori del server. La risposta deve includere sempre un corpo JSON nel seguente formato per tutti i casi di errore:

{
    "name": "camera.info",
    "state": "error",
    "error": {
        "code": "serverError",
        "message": "cannot get camera info."
    }
}
  • name può essere uno qualsiasi tra camera.info, camera.state, camera.checkForUpdates, camera.commands.status e camera.commandName.
  • code deve essere uno dei seguenti per il codice di stato 400:unknownCommand, cameraInExclusiveUse, missingParameter, invalidParameterName o invalidParameterValue.
  • message è definito dai produttori e non è previsto che sia un messaggio localizzato.