Passer au contenu

Overview

  • 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/
Opérations

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
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations

Catalogue

Cette API permet de récupérer tout type d'objet vendable ou tout objet spécifique.

Opérations
Opérations
Opérations
Opérations
Opérations
Opérations

Coupons

Cette API permet de gérer les coupons.

Opérations

Codes promo

Cette API permet de gérer les codes promo.

Opérations

Offres uniques du catalogue

Cette API permet de gérer les offres uniques du catalogue.

Opérations

Remises

Cette API permet de gérer les promotions par réduction

Opérations

Bonus

Cette API permet de gérer les promotions par bonus.

Opérations
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations

Lire la récompense quotidienne de l'utilisateur actuel par son IDClient-side

Requête

Endpoint client. Récupère la récompense quotidienne de l'utilisateur actuel par son ID.

Sécurité
XsollaLoginUserJWT
Chemin
project_idintegerobligatoire

ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.

Exemple: 44056
daily_chain_idintegerobligatoire

ID de récompense quotidienne.

Exemple: 101
curl -i -X GET \
  https://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/project/44056/user/daily_chain/101 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Réponses

Récompense quotidienne de l'utilisateur récupérée avec succès.

Corpsapplication/json
date_startstring(date-time)(calendar_hard_date_start)

Date de début de la récompense quotidienne.

Exemple: "2020-04-15T18:16:00+05:00"
is_recurrentboolean(calendar_hard_is_recurrent)

Détermine si la récompense quotidienne est récurrente. Si true, elle est automatiquement réinitialisée après la date de fin. Le calendrier suivant start_date et end_date est basé sur le nombre d'étapes de la récompense quotidienne et l'heure définie initialement sur start_date.

Par défaut false
Exemple: true
typestring

Type de récompense quotidienne définissant les moments où l'utilisateur peut la réclamer.

Enum ValeurDescription
calendar_hard

Débloque la récompense de l'étape suivante toutes les 24 heures. Toute récompense non réclamée est définitivement perdue dès que l'étape suivante devient disponible.

rolling_skippable

Débloque la récompense de l’étape suivante toutes les 24 heures à partir de date_start. La progression est séquentielle : une nouvelle récompense ne se débloque que lorsque la précédente a été réclamée. Si un utilisateur saute un ou plusieurs jours, il reprend là où il s’est arrêté ; les jours manqués ne génèrent pas de récompenses supplémentaires.

rolling_unskippable

Débloque la récompense de l’étape suivante toutes les 24 heures à partir de date_start. La progression est séquentielle : une nouvelle récompense ne se débloque que lorsque la précédente a été réclamée. Toutefois, si un utilisateur saute un jour, sa progression est réinitialisée et il doit recommencer à partir de la première étape.

Discriminateur
date_endstring or null(date-time)(daily_chain_date_end)

Date de fin de la récompense quotidienne. Peut être null. Si le type est calendar_hard, cette date est automatiquement définie selon le nombre d'étapes ajoutées, et vous pouvez donc la laisser à null.

Exemple: "2020-04-15T18:16:00+05:00"
descriptionstring or null

Description de la récompense quotidienne.

Exemple: "Major weekly quest"
idinteger

ID de récompense quotidienne.

Exemple: 9
namestring

Nom de la récompense quotidienne.

Exemple: "Weekly quest"
orderinteger(order)

Définit l'ordre d'empilement.

Exemple: 1
stepsArray of objects(client-daily-chain-step-model)
Réponse
application/json
{ "date_end": "2025-04-03T18:16:00+05:00", "date_start": "2025-04-01T18:16:00+05:00", "description": "Active daily reward description", "id": 101, "name": "Active daily reward", "order": 1, "steps": [ {}, {}, {}, {} ], "type": "calendar_hard" }

Réclamer une étape de récompense quotidienneClient-side

Requête

Endpoint client. Réclame la récompense d'une étape d'une récompense quotidienne de l'utilisateur actuel. Les étapes doivent être réclamées dans l'ordre séquentiel. Une récompense d'étape manquée ne peut être récupérée ni en monnaie virtuelle ou réelle, ni en regardant une publicité.

Sécurité
XsollaLoginUserJWT
Chemin
project_idintegerobligatoire

ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.

Exemple: 44056
daily_chain_idintegerobligatoire

ID de récompense quotidienne.

Exemple: 101
step_numberintegerobligatoire

Numéro d'étape de récompense quotidienne.

Exemple: 1
curl -i -X POST \
  https://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/project/44056/user/daily_chain/101/step/number/1/claim \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Réponses

Récompense de l'utilisateur actuel pour l'étape de la récompense quotidienne réclamée avec succès.

Réponse
Aucun contenu
Opérations
Opérations
Opérations