공통 오류 정의¶
다음 오류는 해당 OpenAPI 인증, 속도 제한 또는 요청 처리 시나리오에 적용됩니다. 인터페이스 자체의 비즈니스 오류는 각 인터페이스 페이지를 참조하세요.
| HTTP 상태 | errorCode | 발생 조건 및 처리 |
|---|---|---|
| 401 | ft.APIAkKeyFailed | 요청에 API Key가 없습니다. DF-API-KEY 요청 헤더를 확인하세요. |
| 401 | ft.InvalidAPIKey | API Key가 유효하지 않습니다. 사용한 Key와 호출한 사이트를 확인하세요. |
| 403 | ft.APIKeyDisabled | API Key가 비활성화되었습니다. 관리자에게 문의하거나 사용 가능한 Key를 사용하세요. |
| 403 | ft.Forbidden | 현재 Key의 권한이 부족합니다. 인터페이스에 필요한 권한을 확인하세요. |
| 423 | ft.NotInIpWhileList | 액세스 소스가 워크스페이스의 OpenAPI IP 허용 목록에 포함되지 않았습니다. 관리자에게 문의하여 송신 주소를 확인하세요. |
| 401 | ft.TriggerApiAkCurrentLimiting | 현재 API Key가 이전 버전 AK 수준 속도 제한 할당량을 초과했습니다. 빈도를 낮춘 후 다시 시도하세요. |
| 401 | ft.TriggerApiWorkspaceCurrentLimiting | 워크스페이스가 이전 버전 워크스페이스 수준 속도 제한 할당량을 초과했습니다. 해당 워크스페이스의 총 호출 빈도를 낮추세요. |
| 429 | ft.ApiMultiEntryRateLimited | 인터페이스가 구성된 속도 제한 그룹에 도달했습니다. Retry-After(있는 경우)에 따라 백오프하세요. |
| 503 | ft.ApiMultiEntryRateLimitUnavailable | 적용 가능한 속도 제한 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하세요. |
| 400 | ft.RequestJsonFormatError | JSON 구문 오류입니다. content.reason, line, column을 사용해 위치를 파악하세요. 이전 인터페이스에 호환 오류 코드가 있는 경우 인터페이스 페이지를 확인하세요. |
| 406 | ft.ParameterValidationFailed | 매개변수가 선언된 필드 제한을 위반했습니다. message의 필드와 규칙에 따라 요청을 수정하세요. |
| 500 | ft.InternalServerError | 내부 오류입니다. 문제 해결을 위해 응답의 traceId를 저장하세요. |
message는 언어 또는 필드 컨텍스트에 따라 달라질 수 있습니다. 클라이언트는 HTTP 상태 및 errorCode를 기준으로 분기 처리할 수 있습니다.