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

Lire les 10 premiers contributeurs à la chaîne de récompense au sein du clanClient-side

Requête

Récupère la liste des 10 premiers contributeurs à la chaîne de récompense spécifique sous le clan de l'utilisateur actuel. Si l'utilisateur n'appartient pas à un clan, l'appel renvoie un tableau vide.

Sécurité
XsollaLoginUserJWT
Chemin
project_idintegerobligatoire

ID de projet.

Exemple: 44056
reward_chain_idintegerobligatoire

ID de la chaîne de récompenses.

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

Réponses

Liste des 10 premiers contributeurs à la chaîne de récompenses de clan.

Corpsapplication/jsonArray [
contributed_amountinteger

Nombre de points de valeur apportés par l'utilisateur.

Exemple: 100
namestring

ID de l'utilisateur. Il s'agit de l'ID envoyé à Xsolla lors de l'autorisation. Cet ID lie l'utilisateur à votre projet Xsolla Login.

Exemple: "Rocket"
]
Réponse
application/json
[ { "contributed_amount": 555, "name": "winner" }, { "contributed_amount": 398, "name": "Rocket" }, { "contributed_amount": 201, "name": "MrJoe" }, { "contributed_amount": 1, "name": "beginner" } ]

Mise à jour du clan de l'utilisateur actuelClient-side

Requête

Met à jour le clan de l'utilisateur actuel via les attributs utilisateur. Récupère toutes les récompenses non réclamées des chaînes de récompenses associées à un clan précédent et les renvoie dans la réponse. Si l'utilisateur quitte un clan, son appartenance sera révoquée. En cas de changement de clan, le nouveau clan sera mis à jour.

Sécurité
XsollaLoginUserJWT
Chemin
project_idintegerobligatoire

ID de projet.

Par défaut 44056
curl -i -X PUT \
  'https://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/project/{project_id}/user/clan/update' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Réponses

Le clan de l'utilisateur a été mis à jour avec succès.

Corpsapplication/json
rewardArray of objects
Réponse
application/json
{ "reward": [ {}, {} ] }
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations
Opérations