개요
GeoLocation에서 사용자가 설정한 월별 사용 한도 설정 및 월별 최대 호출 건수를 조회합니다.
요청
API URL
GET https://geolocation.apigw.gov-ntruss.com/geolocation/v2/quota
요청 헤더
| 헤더 명 |
설명 |
| x-ncp-apigw-timestamp |
1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(millisecond)로 나타내며 APIGW 서버와 시간차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key |
네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
x-ncp-iam-access-key:{Sub Account Access Key} |
| x-ncp-apigw-signature-v2 |
Access Key ID 값 과 Secret Key 로 암호화한 서명
x-ncp-apigw-signature-v2:{API Gateway Signature} |
응답
응답 Status
| HTTP Status |
Desc |
| 200 |
OK |
| 204 |
OK (No Content) |
| 404 |
Not Found |
| 500 |
Internal Server Error |
응답 바디
| 항목 |
타입 |
설명 |
| type |
String |
제한 또는 무제한 사용 상태 반환(Unlimited 또는 Limited) |
| quota |
int |
설정된 Quota 값(무제한 사용일 경우, -1로 응답) |
예시
{
"resource": {
"type": "Limited",
"quota": 100
}
}
오류 코드
| 오류 코드 |
응답 메세지 |
설명 |
| 130001 |
Invalid Quota |
잘못된 Quota 설정시 발생 |
| 131002 |
Internal Server Error |
GeoLocation 서버의 오류로 발생
일시적이 아닌 경우에는 고객지원 > 문의하기를 통해 문의 바람 |
| 131004 |
Subscription Required |
네이버 클라우드 플랫폼 콘솔 > Application Services > GeoLocation > Subscription 메뉴에서 이용신청한 후에 사용 바람 |
이 외의 코드값에 대해서는 Ncloud API 사용 가이드 > 오류 처리하기를 참조하세요.