Receba recompensa com código promocionalClient-side
get/v2/project/{project_id}/promocode/code/{promocode_code}/rewards
Recebe recompensas de código promocional pelo seu código.
Pode ser usado para permitir que os usuários escolham um dos muitos itens como bônus.
O caso usual é escolher um DRM se o código promocional contiver um jogo como bônus (type=unit).
SecurityXsollaLoginUserJWT
Request
path Parameters
| project_id required | integer ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto. Example: 44056 |
| promocode_code required | string [ 1 .. 128 ] characters Código exclusivo que diferencia maiúsculas de minúsculas. Contém letras e números. Example: SO6rew99j9 |
Responses
200
Lista de recompensas do código promocional recebida com sucesso.
401
Autenticação não aprovada ou errada.
403
Cabeçalho de autorização não enviado.
404
Insira um código promocional válido.
422
Solicitação inválida.
Request samples
- curl
- JavaScript
- Node.js
- Python
- C#
- Go
- Java
curl -i -X GET \ 'https://store.xsolla.com/api/v2/project/{project_id}/promocode/code/{promocode_code}/rewards' \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
Response samples
- 200
- 401
- 403
- 404
- 422
application/json
{- "bonus": [
- {
- "item": {
- "description": "Game description",
- "name": "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": "com.xsolla.game_key_02",
- "type": "game_key"
}
]
}, - "quantity": 1
}, - {
- "item": {
- "description": "Game description",
- "name": "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"
}, - "discounted_items": [
- {
- "discount": {
- "percent": "10.00"
}, - "sku": "com.xsolla.elven_sword_1"
}
], - "is_selectable": true
}