获取优惠券奖励

Xsolla Developers

或

前往发布商帐户

获取优惠券奖励Client-side

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

通过券码获取优惠券奖励。可用于允许用户从众多商品中选择一个作为奖励。通常情况下，如果优惠券包含游戏作为奖励(type=unit)，则为选择一个DRM。

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": {"en": "Game name"
},
"sku": "com.xsolla.game_1",
"type": "unit",
"unit_items": [{"drm_name": "Steam",
"drm_sku": "steam_key_01",
"is_free": false,
"name": "Game name",
"sku": "com.xsolla.game_key_01",
"type": "game_key"
},
{"drm_name": "Origin",
"drm_sku": "origin_key_02",
"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": {"en": "Game name"
},
"sku": "com.xsolla.game_2",
"type": "unit",
"unit_items": [{"drm_name": "Steam",
"drm_sku": "steam_key_01",
"name": "Game name",
"sku": "com.xsolla.game_key_01",
"type": "game_key"
}
]
},
"quantity": 2
}
],
"discount": {"percent": "10.00"
},
"is_selectable": true
}