getQuota

Prev Next

Classic/VPC環境で利用できます。

ユーザーが設定した GeoLocation APIの呼び出し限度タイプと月間最大呼び出し件数を照会します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
GET /quota

リクエストヘッダ

GeoLocation APIで共通して使用されるヘッダの詳細は、GeoLocationのリクエストヘッダをご参照ください。

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET 'https://geolocation.apigw.ntruss.com/geolocation/v2/quota'
--header 'x-ncp-apigw-timestamp: {Timestamp}'
--header 'x-ncp-iam-access-key: {Access Key}'
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
type String Required 限度タイプ
  • Unlimited | Limited
    • Unlimited: 利用無制限
    • Limited: 利用制限
quota Integer Required 設定された月間最大呼び出し件数
  • 限度がUnlimitedの場合、-1を返す

レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。NAVERクラウドプラットフォームでで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

HTTPステータスコード コード メッセージ 説明
204 - OK (No Content) リクエスト成功
400 131001 Invalid Quota 無効な限度設定
400 131002 Internal Server Error GeoLocationサーバエラー
  • 解決方法: しばらくしてから再試行するか、問題が続く場合はサポートに問い合わせる
400 131004 Subscription Required GeoLocationサービスの申し込みが必要
  • 解決方法: NAVERクラウドプラットフォームコンソールの Services > Application Services > GeoLocation > Subscriptionメニューで申し込む
404 - Not Found リソースが見つからない
500 - Internal Server Error 内部サーバエラー

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "resource": {
        "type": "Limited",
        "quota": 100
    }
}