一意のクーポンコード制限を取得する

Xsolla Developers

または

パブリッシャーアカウントへ

一意のクーポンコード制限を取得するServer-sideAdmin

get/v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}

Gets the remaining number of times codes can be used. For filtering the codes, use the codes query parameter.

For configuring the code limit itself, go to the Admin section:

Coupons

SecuritybasicAuth

Request

path Parameters

project_id required	integer プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。 Example: 44056
external_id required	integer プロモーションexternal ID。プロジェクト内での一意のプロモーション識別子。 Example: coupon_44056_1

query Parameters

codes[]	Array of strings 大文字と小文字を区別する一意のコード。文字と数字のみを含めてください。
limit	integer ページでの要素数の制限。 Example: limit=50
offset	integer リストが生成される要素番号（カウントは0から始まります）。 Example: offset=0

Responses

200

コードのクーポン制限を正常に受け取りました。

401

基本認証が不合格または不正です。基本認証または正しい認証情報を使用したことを確認してください。

404

アイテムが見つかりません。

422

無効なリクエストです。

Request samples

curl -i -X GET \
  -u <merchant_id_or_project_id>:<api_key> \
  'https://store.xsolla.com/api/v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}?codes%5B%5D=string&limit=50&offset=0'

Response samples

application/json

{"has_more": false,
"items": [{"code": "WINTER2023",
"per_code": {"available": 7,
"reserved": 1,
"total": 10,
"used": 2
}
},
{"code": "SUMMER2023",
"per_code": {"available": 0,
"reserved": 2,
"total": 5,
"used": 3
}
}
],
"promotion_id": 1,
"total_items_count": 2
}

一意のクーポンコード制限を取得するServer-sideAdmin

path Parameters

query Parameters

We respect your privacy