> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 오류 참조

> Living Security /v1 공개 API가 반환할 수 있는 모든 오류와 각 오류의 고정 머신 코드, HTTP 상태, 해결 방법을 설명합니다.

모든 `/v1` 오류 응답은 고정된 필드 집합을 가진 `application/problem+json`([RFC 9457](https://www.rfc-editor.org/rfc/rfc9457))입니다.

```json theme={null}
{
  "type": "https://docs.livingsecurity.com/developers/v1/errors/resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "No such organization.",
  "code": "resource_not_found",
  "request_id": "req_...",
  "doc_url": "https://docs.livingsecurity.com/developers/v1/errors/resource_not_found",
  "retryable": false
}
```

분기 처리는 반드시 `code`를 기준으로 하고 `detail`는 기준으로 삼지 마십시오. `code`는 안정적인 머신 계약이며, `detail`는 사람이 읽을 수 있는 설명으로 변경될 수 있습니다. `param`는 오류가 특정 요청 매개변수에서 비롯된 경우에 포함됩니다. 지원팀에 문의할 때는 `request_id`를 함께 전달하십시오.

## 오류 코드

| 코드 | HTTP 상태 | 재시도 가능 여부 |
| - | - | - |
| [`unauthorized`](/ko/developers/v1/errors/unauthorized) | 401 | 아니요 |
| [`credential_inactive`](/ko/developers/v1/errors/credential_inactive) | 401 | 아니요 |
| [`credential_expired`](/ko/developers/v1/errors/credential_expired) | 401 | 아니요 |
| [`credential_revoked`](/ko/developers/v1/errors/credential_revoked) | 401 | 아니요 |
| [`not_entitled`](/ko/developers/v1/errors/not_entitled) | 403 | 아니요 |
| [`insufficient_permission`](/ko/developers/v1/errors/insufficient_permission) | 403 | 아니요 |
| [`permission_denied`](/ko/developers/v1/errors/permission_denied) | 403 | 아니요 |
| [`resource_not_found`](/ko/developers/v1/errors/resource_not_found) | 404 | 아니요 |
| [`invalid_request`](/ko/developers/v1/errors/invalid_request) | 400 또는 409 | 아니요 |
| [`invalid_filter`](/ko/developers/v1/errors/invalid_filter) | 400 | 아니요 |
| [`unsupported_version`](/ko/developers/v1/errors/unsupported_version) | 400 | 아니요 |
| [`idempotency_key_reuse`](/ko/developers/v1/errors/idempotency_key_reuse) | 409 | 충돌 유형에 따라 다름 |
| [`rate_limited`](/ko/developers/v1/errors/rate_limited) | 429 | 예 |
| [`service_unavailable`](/ko/developers/v1/errors/service_unavailable) | 503 | 예 |
| [`internal_error`](/ko/developers/v1/errors/internal_error) | 500 | 예 |

코드 집합은 고정되어 있으며, 새로운 코드 추가는 공개 계약의 변경에 해당하므로 API 변경 로그를 통해 공지됩니다. `retryable: true` 응답은 해당 상태가 해소될 수 있음을 의미할 뿐, 쓰기 작업이 아무런 영향을 주지 않았음을 보장하지는 않습니다. 읽기 요청은 시도 횟수와 시간 예산을 한정하고 지수 백오프와 지터를 적용하여 재시도하십시오. 재시도 가능한 `409` 또는 `429` 응답을 포함하여 `Retry-After`가 있는 경우에는 이를 준수하십시오.

변경 작업(mutation)의 경우 해당 작업에 문서화된 멱등성 및 복구 계약을 따르십시오. 지원되는 경우 원래의 키와 요청을 그대로 유지하십시오. 타임아웃이나 `5xx` 이후에 새 키를 임의로 생성하지 마십시오. 그렇게 하면 이미 성공한 쓰기가 반복될 수 있습니다. `Idempotency-Key` 헤더는 이를 지원하지 않는 작업에서는 어떠한 보호도 제공하지 않습니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.