오류 코드 및 문제 해결

오류 응답 형식

1 {
2   "code": 1003,
3   "message": "Invalid token",
4   "requestId": "req-12345678"
5 }

비즈니스 오류는 보통 통합 JSON 구조를 반환합니다. 통합업체는 먼저 이 code 을 확인해야 합니다. 인증 실패는 HTTP 401반환할 수 있습니다; 속도 제한이 HTTP 429다시 돌아올 수 있습니다.

문제	추천
유효한 인증 정보가 없다`1001`	`Authorization: Bearer <accessToken>` 또는 `X-API-KEY`가 포함되어 있는지 확인하세요.
`1002` 토큰 만료	다시 시도하기 전에 토큰을 새로고침하거나 다시 로그인하세요.
`1003` 무효 토큰, API Key또는 서명	API Key, 서명 페이로드, 요청 본JSON 문자열, 쿼리 매개변수 순서를 확인하세요.
`1006` 불일치 IP 출처	API Key IP 화이트리스트 구성을 확인해 보세요.
`3004` 중복 요청	순서 관련 경로에 동일한 서명을 재사용하지 마세요. 재생 `timestamp` `signature`.
`5003` 요금 한도 발동됨	요청 빈도를 줄이고 재시도할 때는 지수 백오프를 사용하세요.
`Timestamp outside of tolerance window`	`/v1/time`에 전화해서 시간 오프셋을 조정하고 다시 요청서에 서명하세요.