Aktionscode überprüfenClient-side
get/v2/project/{project_id}/promotion/code/{code}/verify
Prüft, ob es sich bei dem Code um einen Promocode oder einen Gutscheincode handelt und ob der Nutzer ihn anwenden kann.
SecurityXsollaLoginUserJWT
Request
path Parameters
| project_id required | integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056 |
| code required | string [ 1 .. 128 ] characters Eindeutiger Code, bei dem die Groß-/Kleinschreibung beachtet wird. Enthält Buchstaben und Zahlen. Example: WINTER2021 |
Responses
200
Informationen zum Code.
401
Authentifizierung nicht bestanden oder falsch.
403
Autorisierungs-Header nicht gesendet.
404
Code nicht gefunden. Prüfen Sie, ob der code-Wert korrekt ist.
422
Ungültige Code-Aktion.
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"
}