개요
GeoLocation에서 호출 가능한 월별 사용 한도 설정 및 월별 최대 호출 건수를 수정합니다. 수정이 반영되기까지 1분 내외의 시간이 소요됩니다.
요청
API URL
POST https://geolocation.apigw.gov-ntruss.com/geolocation/v2/quota?quota=2000
요청 헤더
헤더 명 |
설명 |
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} |
요청 파라메터
파라미터 명 |
필수 여부 |
타입 |
제약사항 |
설명 |
quota |
Y |
String |
unlimit 또는 제한량(ex:100) |
무제한 요청일 경우 unlimit를 입력하고, 월별 사용 한도를 제한하고 싶은 경우 사용하고자 하는 최대 호출 건수를 입력 |
응답
응답 Status
HTTP Status |
Desc |
204 |
OK (No Content) |
404 |
Not Found |
500 |
Internal Server Error |
예시
정상 응답
HTTP Status : 204
에러 응답
{
"error": {
"errorCode": 130001,
"message": "Invalid Quota",
"details": null
}
}
오류 코드
오류 코드 |
응답 메세지 |
설명 |
130001 |
Invalid Quota |
잘못된 Quota 설정시 발생 |
131002 |
Internal Server Error |
GeoLocation 서버의 오류로 발생 일시적이 아닌 경우에는 고객지원 > 문의하기를 통해 문의 바람 |
131004 |
Subscription Required |
네이버 클라우드 플랫폼 콘솔 > Application Services > GeoLocation > Subscription 메뉴에서 이용신청한 후에 사용 바람 |
이 외의 코드값에 대해서는 Ncloud API 사용 가이드 > 오류 처리하기를 참조하세요.