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 errori nell'intervallo 4XX per gli errori del client e nell'intervallo 5XX per gli errori del server. La risposta deve sempre includere un corpo JSON nel formato seguente per tutti i casi di errore:
{
"name": "camera.info",
"state": "error",
"error": {
"code": "serverError",
"message": "cannot get camera info."
}
}
name
può essere un valore 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 è destinato a essere localizzato
.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-08-21 UTC.
[null,null,["Ultimo aggiornamento 2024-08-21 UTC."],[[["Always use the `400 Bad Request` status code for errors defined in the specification and appropriate 4XX or 5XX codes for other client or server errors, respectively."],["All error responses must include a JSON body with `name`, `state`, and an `error` object containing `code` and `message`."],["The `error.code` field uses predefined values for 400 errors (`unknownCommand`, `cameraInExclusiveUse`, `missingParameter`, `invalidParameterName`, `invalidParameterValue`) while manufacturers define the `error.message`."],["The `name` field identifies the specific request, such as `camera.info` or `camera.commands.status`, associated with the error."]]],["Error responses must include a JSON body with \"name,\" \"state,\" and \"error\" fields. For specified errors, use the `400 Bad Request` status code, otherwise, employ 4XX for client and 5XX for server errors. The \"name\" field can be one of several camera-related identifiers. \"Code\" within the error object must be one of five predefined error codes for 400 responses. The \"message\" field is free-form, manufacturer-defined, and non-localized.\n"]]