setQuota

Prev Next

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

GeoLocation APIの呼び出し限度タイプと月間最大呼び出し件数を設定します。設定が反映されるまで1分ほどかかります。

リクエスト

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

メソッド URI
POST /quota

リクエストヘッダ

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

リクエストクエリパラメータ

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
quota String Required 設定したい限度タイプと月間最大呼び出し件数
  • 限度を無制限に設定する場合、unlimitと入力
  • 月間使用限度を制限したい場合は、最大呼び出し件数を入力

リクエスト例

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

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

レスポンス

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

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

レスポンスステータスコードの説明は次の通りです。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 内部サーバエラー

レスポンス例

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

正常レスポンス

HTTP Status : 204

エラーレスポンス

{
    "error": {
        "errorCode": 130001,
        "message": "Invalid Quota",
        "details": null
    }
}