콘텐츠로 이동

공통 오류 정의

다음 오류는 해당 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를 기준으로 분기 처리할 수 있습니다.

문서 평가

이 페이지가 도움이 되었나요?