getQuota

개요

GeoLocation에서 사용자가 설정한 월별 사용 한도 설정 및 월별 최대 호출 건수를 조회합니다.

요청

API URL

GET https://geolocation.apigw.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 네이버 클라우드 플랫폼 콘솔 > Naver API > GeoLocation > Subscription 메뉴에서 이용신청한 후에 사용하세요.

이 외의 코드값에 대해서는 Ncloud API 사용 가이드 > 오류 처리하기를 참조하세요.