공통 오류 정의¶
다음 오류는 External API의 공통 인증 및 요청 처리에 적용됩니다. 인터페이스 자체의 비즈니스 오류는 각 인터페이스 페이지를 참조하십시오.
| HTTP 상태 | errorCode | 발생 조건 및 처리 |
|---|---|---|
| 400 | ft.InvalidNonce | nonce가 누락되었거나 재사용되었습니다. 재시도할 때마다 새 nonce를 사용하고 다시 서명합니다. |
| 400 | ft.MissingAuthHeaderInfo | Access Key, 서명 또는 타임스탬프가 누락되었습니다. 서명 요청 헤더를 확인합니다. |
| 400 | ft.IllegalTimestamp | 타임스탬프가 구성된 허용 오차를 초과했습니다. 클라이언트 시계를 동기화하고 Unix 초를 사용하여 다시 서명합니다. |
| 403 | ft.CrosssValidateFailed | 서명이 일치하지 않습니다. 서명 버전, 원본 요청 경로, 쿼리 문자열 및 서명 원문을 확인합니다. |
| 403 | ft.Forbidden | 서명 계정의 권한이 부족합니다. 인터페이스에 필요한 읽기/쓰기 권한을 확인합니다. |
| 404 | ft.InvalidAccessKey | Access Key가 유효하지 않습니다. 호출 사이트 및 플랫폼 계정 구성을 확인합니다. |
| 404 | ft.NotFoundAkSkCfg | 서비스에서 External API 서명 계정 구성을 찾지 못했습니다. 서비스 관리자에게 문의합니다. |
| 406 | ft.ParameterValidationFailed | 매개변수가 선언된 필드 제한을 위반했습니다. message의 필드와 규칙에 따라 요청을 수정합니다. |
| 400 | ft.RequestJsonFormatError | JSON 구문 오류입니다. content.reason, line 및 column을 사용하여 위치를 파악합니다. |
| 429 | ft.ApiMultiEntryRateLimited | 인터페이스가 구성된 요청 제한 그룹에 도달했습니다. Retry-After(있는 경우)에 따라 백오프하고 새 nonce로 다시 서명합니다. |
| 503 | ft.ApiMultiEntryRateLimitUnavailable | 적용 가능한 요청 제한 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도합니다. |
| 500 | ft.InternalServerError | 내부 오류입니다. 응답의 traceId를 저장하여 문제 해결에 사용합니다. |
message는 언어 또는 필드 컨텍스트에 따라 달라질 수 있습니다. 클라이언트는 HTTP 상태와 errorCode를 기준으로 분기 처리할 수 있습니다.