ID de la promotion. Identifiant unique de la promotion au sein du projet.
- Définir la limite de promotion pour un utilisateur spécifique
Actualiser toutes les limites d'achat pour un utilisateur spécifique
Réduire le nombre d'objets offerts pour un utilisateur spécifique
Lire le nombre d'objets offerts pour un utilisateur spécifique
Augmenter le nombre d'objets offerts pour un utilisateur spécifique
Définir le nombre d'objets offerts pour un utilisateur spécifique
Actualiser la limite d'achat
Actualiser toutes les limites de promotion pour un utilisateur spécifique
Réduire la limite de promotion pour un utilisateur spécifique
Lire la limite de promotion pour un utilisateur spécifique
Augmenter la limite de promotion pour un utilisateur spécifique
Actualiser la limite d'une promotion pour les utilisateurs
Définir la limite de prom...
Shop Builder API (2.0.0)
- Version: 2.0.0
- Servers:
https://store.xsolla.com/api - Contact Us by Email
- Contact URL: https://xsolla.com/
- Required TLS version: 1.2
Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc.
Télécharger la description d'OpenAPI
Langues
Serveurs
Mock server
https://xsolla.redocly.app/_mock/fr/api/shop-builder/
https://store.xsolla.com/api/
Catalogue personnalisé
Cette API permet de spécifier des règles pour les attributs utilisateur. Si l'utilisateur remplit toutes les conditions d'une règle concrète, des objets personnalisés seront affichés.
Pour les promotions personnalisées, voir la section Promotions.
Pour passer des attributs avant un achat, utilisez Xsolla Login API ou passez-les dans la propriété user.attributes lors de la génération du jeton à l'aide de Pay Station API.
Opérations
Requête
Augmente le nombre de fois qu'un utilisateur spécifique peut utiliser la promotion dans la limite appliquée.
L'API des limites utilisateur vous permet de limiter le nombre de fois qu'un utilisateur peut utiliser une promotion. Pour configurer les limites utilisateur, accédez à la section Administrateur du type de promotion souhaité :
Sécurité
basicAuth
Chemin
Corpsapplication/jsonID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.
Exemple: 44056
Nombre restant d'objets ou d'utilisations de la promotion disponibles pour l'utilisateur dans la limite appliquée.
- Mock serverhttps://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}
- https://store.xsolla.com/api/v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/project/44056/admin/user/limit/promotion/id/111425 \
-H 'Content-Type: application/json' \
-d '{
"available": 1,
"user": {
"user_external_id": "d342dad2-9d59-11e9-a384-42010aa8003f"
}
}'Réponse
application/json
{ "per_user": { "available": 9, "total": 10 } }
Requête
Définit le nombre de fois qu'un utilisateur spécifique peut utiliser une promotion dans la limite appliquée après une augmentation ou une diminution.
L'API des limites utilisateur vous permet de limiter le nombre de fois qu'un utilisateur peut utiliser une promotion. Pour configurer les limites utilisateur, accédez à la section Administrateur du type de promotion souhaité :
Sécurité
basicAuth
Chemin
Corpsapplication/jsonID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.
Exemple: 44056
Nombre restant d'objets ou d'utilisations de la promotion disponibles pour l'utilisateur dans la limite appliquée.
- Mock serverhttps://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}
- https://store.xsolla.com/api/v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/project/44056/admin/user/limit/promotion/id/111425 \
-H 'Content-Type: application/json' \
-d '{
"available": 0,
"user": {
"user_external_id": "d342dad2-9d59-11e9-a384-42010aa8003f"
}
}'Réponse
application/json
{ "per_user": { "available": 9, "total": 10 } }
Requête
Actualise la limite de la promotion afin que l'utilisateur puisse à nouveau utiliser cette promotion. Si le paramètre user est défini sur null, cet appel actualise cette limite pour tous les utilisateurs.
L'API des limites utilisateur vous permet de limiter le nombre de fois qu'un utilisateur peut utiliser une promotion. Pour configurer les limites utilisateur, accédez à la section Administrateur du type de promotion souhaité :
Sécurité
basicAuth
Chemin
Corpsapplication/jsonID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.
Exemple: 44056
- Mock serverhttps://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}/all
- https://store.xsolla.com/api/v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}/all
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/project/44056/admin/user/limit/promotion/id/111425/all \
-H 'Content-Type: application/json' \
-d '{
"user": {
"user_external_id": "d342dad2-9d59-11e9-a384-42010aa8003f"
}
}'