콘텐츠로 이동

공통 오류 정의

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

문서 평가

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