Gutscheinbelohnung abrufenClient-side
get/v2/project/{project_id}/coupon/code/{coupon_code}/rewards
Ruft Gutscheinbelohnungen anhand des Codes ab.
Dadurch können Benutzer aus mehreren Bonusartikeln wählen.
Als Normalfall gilt die Wahl eines DRM-Systems, wenn der Gutschein 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 |
| coupon_code required | string [ 1 .. 128 ] characters Eindeutiger Code, es wird zwischen Groß- und Kleinschreibung unterschieden. Enthält Buchstaben und Ziffern. Example: WINTER2021 |
Responses
200
Die Liste der Gutscheinprämien wurde erfolgreich empfangen.
401
Authentifizierung nicht bestanden oder falsch.
403
Autorisierungs-Header nicht gesendet.
404
Geben Sie einen gültigen Gutscheincode ein.
422
Ungültige Anfrage.
Request samples
- curl
- JavaScript
- Node.js
- Python
- C#
- Go
- Java
Response samples
- 200
- 401
- 403
- 404
- 422
application/json
{- "bonus": [
- {
- "item": {
- "description": "Game description",
- "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",
- "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
}