# 오류

> 오류 카탈로그: HTTP 상태, OperationOutcome 이슈 코드 및 각 항목에 대한 조치 방법.

Source: https://developers.anpheros.com/ko/guides/errors

`/fhir/R4` 오류는 `OperationOutcome`이며, 그 외에는 `{"error": {"type", "message", "field"?}}`입니다. 모든 응답에는 `Anpheros-Request-Id`가 포함되어 있습니다. 지원팀에 문의할 때 이를 인용하십시오.

| HTTP | `issue.code` / `type` | 의미 | 조치 방법 |
|---|---|---|---|
| 400 | `invalid`, `structure`, `value` | 잘못된 형식의 JSON, 유효하지 않은 FHIR, 필수 값 세트에 없는 값, 지원되지 않는 검색 매개변수, 지원되지 않는 범위 필터 | 요청 수정; 메시지에 필드 이름이 명시됨 |
| 400 | `too-costly` | 리소스 중첩 64 레벨 초과, 텍스트 10,000자 초과 | 리소스 단순화 |
| 401 | `login` | 누락, 알 수 없거나 만료 또는 취소된 자격 증명; 동의가 더 이상 활성 상태가 아님; 응답에 `WWW-Authenticate: Bearer realm="anpheros"` 포함 (자격 증명이 전송된 경우 `error="invalid_token"` 포함) | 재인증; OAuth의 경우, 새로고침 또는 재동의 |
| 403 | `forbidden` | 범위, 소유권(다른 조직에서 작성), 읽기 전용 권한, 관리자 전용 | 올바른 범위 요청; 자체 리소스 작성 |
| 404 | `not-found` | 이 호출자에게 존재하지 않음 | 404에서 존재 여부를 절대 가정하지 마십시오 |
| 409 | `conflict` | 동일성 키 처리 중; 문서가 이미 최종 상태임; 엔드포인트 제한 | 잠시 후 재시도 / 새 키 사용 |
| 410 | `deleted` | 리소스 또는 파일 삭제됨 | — |
| 412 | `conflict` | `If-Match` 버전 불일치 | 다시 읽은 후 업데이트 |
| 413 | `too-costly` | 본문 또는 문서가 제한 초과 | 분할 또는 압축 |
| 422 | `not-found` / `invalid` | 참조된 환자가 귀하에게 존재하지 않음; 환자 간 리소스 이동; 동일성 키가 다른 본문과 함께 재사용됨 | 참조 수정 |
| 429 | `throttled` | 자격 증명별 또는 IP별 속도 제한 | `Retry-After`초 대기; SDK에서 처리함 |
| 503 | `transient` | 문서 저장소 사용 불가 | 백오프와 함께 재시도 |
| 500 | `exception` | 예상치 못한 오류, 요청 ID와 함께 로깅 및 감사됨 | 요청 ID 보고 |