Verificar o código promocionalClient-side
get/v2/project/{project_id}/promotion/code/{code}/verify
Determina se o código é um código promocional ou código de cupom e se o usuário pode aplicá-lo.
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 |
| code required | string [ 1 .. 128 ] characters Código exclusivo que diferencia maiúsculas de minúsculas. Contém letras e números. Example: WINTER2021 |
Responses
200
Informações sobre o código.
401
Autenticação não aprovada ou errada.
403
Cabeçalho de autorização não enviado.
404
Código não encontrado. Verifique se o valor code está correto.
422
Promoção de código 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}/promotion/code/{code}/verify' \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
Response samples
- 200
- 401
- 403
- 404
- 422
application/json
{- "code": "WINTER2023",
- "rewards": {
- "bonus": [
- {
- "item": {
- "description": "Game description",
- "name": "Game name",
- "sku": "com.xsolla.game_1",
- "type": "unit",
- "unit_items": [
- {
- "drm_name": "Steam",
- "drm_sku": "steam_key_1",
- "is_free": false,
- "name": "Game name",
- "sku": "com.xsolla.game_key_01",
- "type": "game_key"
}, - {
- "drm_name": "Origin",
- "drm_sku": "origin_key_1",
- "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_1",
- "name": "Game name",
- "sku": "com.xsolla.game_key_01",
- "type": "game_key"
}
]
}, - "quantity": 2
}
], - "is_selectable": true
}, - "type": "coupon"
}