クーポン特典を入手

クーポン特典を入手Client-side

get/v2/project/{project_id}/coupon/code/{coupon_code}/rewards

このコードによりクーポン特典を入手します。ユーザーが多くのアイテムの中から1つをボーナスとして選択できるようにするために使用することができます。通常のケースでは、クーポンにボーナスとしてゲームが含まれている場合、DRMを選択します（type=unit）。

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id required	integer プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。 Example: 44056
coupon_code required	string [ 1 .. 128 ] characters 大文字と小文字を区別する一意のコードです。文字と数字が含まれます。 Example: WINTER2021

Responses

200

クーポンリワードのリストは正常に受信されました。

401

認証を通過できず、または間違っています。

403

認証ヘッダーが送信されていません。

404

有効なクーポンコードを入力してください。

422

無効なリクエスト。

Request samples

Response samples

application/json

{"bonus": [{"item": {"description": "Game description",
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"name": "Game name",
"sku": "game_1",
"type": "unit",
"unit_items": [{"drm_name": "Steam",
"drm_sku": "steam",
"is_free": false,
"name": "Game name",
"sku": "game_key_01",
"type": "game_key"
},
{"drm_name": "Origin",
"drm_sku": "origin",
"name": "Game name",
"sku": "game_key_02",
"type": "game_key"
}
]
},
"quantity": 1
},
{"item": {"description": "Game description",
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"name": "Game name",
"sku": "game_2",
"type": "unit",
"unit_items": [{"drm_name": "Steam",
"drm_sku": "steam",
"name": "Game name",
"sku": "game_key_01",
"type": "game_key"
}
]
},
"quantity": 2
}
],
"discount": {"percent": "10.00"
},
"is_selectable": true
}