Obsługa błędów
W przypadku wszystkich błędów zdefiniowanych w tej specyfikacji użyj kodu stanu 400 Bad Request
. W przypadku pozostałych błędów producenci powinni podawać błędy w zakresie 4XX w przypadku błędów klienta i 5XX w przypadku błędów serwera. W przypadku wszystkich przypadków błędu odpowiedź powinna zawsze zawierać treść JSON w tym formacie:
{
"name": "camera.info",
"state": "error",
"error": {
"code": "serverError",
"message": "cannot get camera info."
}
}
name
może być dowolnym z tych elementów: camera.info
, camera.state
, camera.checkForUpdates
,
camera.commands.status
i camera.commandName
.
- W przypadku kodu stanu 400
code
powinna mieć jeden z tych ciągów:unknownCommand
,
cameraInExclusiveUse
, missingParameter
, invalidParameterName
lub
invalidParameterValue
.
- Wartość
message
jest definiowana przez producentów i nie powinna być zlokalizowana
.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-08-21 UTC.
[null,null,["Ostatnia aktualizacja: 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"]]