Error Codes
에러는 통합 설정 또는 API 호출 자체와 관련될 수 있습니다. 먼저 설정이 올바른지 확인한 다음 API 호출/요청 URL을 확인하는 것이 좋습니다. 필수 매개변수 누락과 같은 일반적인 오류를 해결하려면 제공된 쿼리 매개변수와 값을 확인하십시오.
에러 처리
에러는 표준 HTTP 오류 코드 구문을 사용하여 반환됩니다. 다음과 같은 유형의 메시지를 수신할 수 있습니다.
- Success - API에 성공적으로 요청을 보냈습니다.
- Request Errors - 요청한 정보가 올바르지 않습니다.
- Authentication Error - 본인 확인에 문제가 발생했습니다.
에러 코드
| HTTP 상태 코드 | 설명 |
|---|---|
| 200 | OK |
| 304 | Not modified |
| 401 | Developer inactive 세션이 종료되었을 수 있습니다. 예를 들어 서명이 더 이상 유효하지 않아 새 서명이 필요하거나, I/O 문서를 사용 중인 경우 로그인 후 다시 시도해야 합니다. 모든 경우에 새 서명을 생성하고 새 호출을 하기 전에 API 키가 올바른지 확인하십시오. |
| 401 | Unauthorized/Not Authorized 권한이 부족합니다. 구독 범위 외의 리소스에 액세스하려고 시도했거나, API 키 또는 시크릿이 잘못되었거나, 고유 서명이 더 이상 유효하지 않아 새 서명이 필요할 수 있습니다. API 호출에는 반드시 고유 서명을 포함해야 합니다. 서명을 하드코딩하면 만료되므로 사용하지 마십시오. 인증 가이드에 설명된 대로 애플리케이션은 API 호출에 사용할 새 서명을 정기적으로 생성해야 합니다. 모든 경우에 새 서명을 생성하고 새 API 호출을 하기 전에 API 키가 올바른지 확인하십시오. 서명은 SHA256 해시로 생성해야 합니다. |
| 401 | Waiting 계정이 설정되었지만 아직 활성화되지 않았습니다. 이 오류가 계속 발생하는 경우 계정 관리자에게 문의하여 계정을 활성화하세요. |
| 403 | Forbidden 접근이 금지되었습니다. |
| 403 | Client exceeded queries limit 클라이언트에게 허용된 쿼리수가 초과되었습니다. |
| 403 | Timestamp is invalid 요청한 타임스탬프가 잘 못 되었습니다. |
| 403 | Service requires SSL 서비스 요청시 SSL이 필요합니다. |
| 403 | Invalid API key CID pair 잘못된 API 키 CID 쌍입니다. |
| 403 | Invalid API plan 잘못된 API 계획입니다. |
| 403 | CORS origin deniedCORS 위반 에러입니다. |
| 403 | Developer Over QPS 각 API 계정에는 초당 호출 횟수 제한이 있습니다. 이 제한을 초과하면 이후 API 호출은 실패하고 오류가 반환됩니다. 다음 초에 다시 호출하면 정상적으로 처리됩니다. 이 문제를 방지하는 가장 쉬운 방법은 이전 호출이 완료된 후에 다음 호출이 실행되도록 설계하는 것입니다. |
| 403 | Developer Over Limit 각 API 계정에는 일일/월간 API 호출 횟수 제한이 있습니다. 제한 횟수가 초과되면 해당 제한이 해제될 때까지 API 호출이 계속 실패하고 이 오류가 발생합니다. 담당 계정 관리자에게 문의하여 도움을 받으세요. |
| 404 | Data not found / Not found 사용 가능한 데이터가 없습니다(데이터가 실제로 존재하지 않을 수 있습니다). 이러한 현상은 여러 가지 이유로 발생할 수 있으며, 몇 가지 예는 다음과 같습니다.
|
| 405 | Mehtod Not Allowed 허락되지 않은 HTTP 메서드 입니다. |
| 500 | Internal server error |
| 501 | Not implemented |
| 502 | Bad gateway |
| 503 | Service unavailable |
| 504 | Gateway timeout |
| 596 | Invalid preflight CORS request Origin 헤더가 누락되었거나 요청의 HTTP 메서드가 OPTIONS가 아닙니다. |
| 596 | Service Not Found 다음과 같은 상황에서 이 오류 메시지가 표시됩니다.
|