Promocode-Belohnung abrufenClient-side
get/v2/project/{project_id}/promocode/code/{promocode_code}/rewards
Ruft Promocode-Belohnungen anhand des Codes ab.
Dadurch können Benutzer aus mehreren Bonusartikeln wählen.
Als Normalfall gilt die Wahl eines DRM-Systems, wenn der Promocode ein Spiel als Bonus enthält (type=unit).
SecurityXsollaLoginUserJWT
Request
path Parameters
| project_id required | integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056 |
| promocode_code required | string [ 1 .. 128 ] characters Eindeutiger Code, es wird zwischen Groß- und Kleinschreibung unterschieden. Enthält Buchstaben und Ziffern. Example: SO6rew99j9 |
Responses
200
Die Liste der Promocode-Prämien wurde erfolgreich empfangen.
401
Authentifizierung nicht bestanden oder falsch.
403
Autorisierungs-Header nicht gesendet.
404
Geben Sie einen gültigen Promocode ein.
422
Ungültige Anfrage.
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
}