오류 처리
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 사양에 정의된 모든 오류에는 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은(는) 제조업체에서 정의하며 현지화되지 않을 것으로 예상됩니다.
메시지가 표시됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eAlways use the \u003ccode\u003e400 Bad Request\u003c/code\u003e status code for errors defined in the specification and appropriate 4XX or 5XX codes for other client or server errors, respectively.\u003c/p\u003e\n"],["\u003cp\u003eAll error responses must include a JSON body with \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003estate\u003c/code\u003e, and an \u003ccode\u003eerror\u003c/code\u003e object containing \u003ccode\u003ecode\u003c/code\u003e and \u003ccode\u003emessage\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eerror.code\u003c/code\u003e field uses predefined values for 400 errors (\u003ccode\u003eunknownCommand\u003c/code\u003e, \u003ccode\u003ecameraInExclusiveUse\u003c/code\u003e, \u003ccode\u003emissingParameter\u003c/code\u003e, \u003ccode\u003einvalidParameterName\u003c/code\u003e, \u003ccode\u003einvalidParameterValue\u003c/code\u003e) while manufacturers define the \u003ccode\u003eerror.message\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ename\u003c/code\u003e field identifies the specific request, such as \u003ccode\u003ecamera.info\u003c/code\u003e or \u003ccode\u003ecamera.commands.status\u003c/code\u003e, associated with the error.\u003c/p\u003e\n"]]],["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"],null,["# Error handling\n\nUse 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: \n\n {\n \"name\": \"camera.info\",\n \"state\": \"error\",\n \"error\": {\n \"code\": \"serverError\",\n \"message\": \"cannot get camera info.\"\n }\n }\n\n- `name` can be any of `camera.info`, `camera.state`, `camera.checkForUpdates`, `camera.commands.status`, and `camera.commandName`.\n- `code` should be one of the following for 400 status code:`unknownCommand`, `cameraInExclusiveUse`, `missingParameter`, `invalidParameterName`, or `invalidParameterValue`.\n- `message` is defined by manufacturers and is not expected to be a localized message."]]
