Xsolla-logoXsolla Developers
前往发布商帐户

通过代码获取兑换型促销活动Server-sideAdmin

get/v2/project/{project_id}/admin/promotion/redeemable/code/{code}

通过促销码或优惠券码获取促销活动。

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

项目ID。您可以在您的发布商帐户项目名称旁边找到。

Example: 44056
code
required
string [ 1 .. 128 ] characters

唯一区分大小写的代码。包含字母和数字。

Example: WINTER2021
Responses
200

成功收到促销活动。

401

基本认证未通过或错误。确保您使用了基本认证或正确的凭据。

404

未找到兑换码。请确保提供的代码值正确无误。

405

兑换码格式不正确。该代码只能包含字母和数字。

Request samples
curl -i -X GET \
  -u <merchant_id_or_project_id>:<api_key> \
  'https://store.xsolla.com/api/v2/project/{project_id}/admin/promotion/redeemable/code/{code}'
Response samples
application/json
{
  • "bonus": [
    ],
  • "date_end": "2023-04-30T23:59:59+05:00",
  • "date_start": "2023-04-15T01:00:00+05:00",
  • "external_id": "coupon_fall_hammer_2",
  • "is_enabled": true,
  • "name": {
    },
  • "redeem_code_limit": null,
  • "redeem_total_limit": 99,
  • "redeem_user_limit": 1
}