setQuota

Prev Next

개요

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 사용 가이드 > 오류 처리하기를 참조하세요.