Passer au contenu

Aperçu

  • Version : 2.0.0
  • Serveurs : https://store.xsolla.com/api
  • Contactez-nous par e-mail
  • **URL de contact :**https://xsolla.com/
  • Version TLS requise : 1.2

L’API Catalog permet de configurer un catalogue des objets en jeu côté Xsolla et de l’afficher aux utilisateurs dans votre magasin.

L’API permet de gérer les entités de catalogue suivantes :

  • Objets virtuels — objets en jeu tels que armes, skins, boosters.
  • Monnaie virtuelle — monnaie utilisée pour acheter des objets virtuels.
  • Packages de monnaie virtuelle — lots prédéfinis de monnaie virtuelle.
  • Lots — packages combinant objets virtuels, monnaie virtuelle ou clés de jeu vendus sous un seul UGS.
  • Clés de jeu — clés pour jeux et DLC distribuées via Steam ou d’autres fournisseurs DRM.
  • Groupes — regroupements logiques pour organiser et trier les éléments du catalogue.

Appels API

L’API est divisée en groupes suivants :

  • Admin — appels pour créer, mettre à jour, supprimer et configurer les objets et groupes du catalogue. Authentification via l’authentification d’accès de base avec vos identifiants marchand ou projet. Non destinés à un usage côté magasin.
  • Catalog — appels pour récupérer des objets et construire des vitrines personnalisées pour les utilisateurs finaux. Conçue pour gérer des charges importantes. Supporte l’autorisation optionnelle par JWT utilisateur pour retourner des données personnalisées telles que des limites spécifiques à l’utilisateur et des promotions actives.
Télécharger la description d'OpenAPI
Langues
Serveurs
https://store.xsolla.com/api/
Mock server
https://xsolla.redocly.app/_mock/fr/api/catalog/
Opérations
Opérations
Opérations
Opérations
Opérations
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 les informations sur les paramètres du webhookServer-sideAdmin

Requête

Récupère les informations sur les paramètres du webhook dans Store. Consultez la documentation sur les webhooks pour en savoir plus.

Sécurité
basicAuth
Chemin
project_idintegerobligatoire

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

Exemple: 44056
curl -i -X GET \
  -u <username>:<password> \
  https://store.xsolla.com/api/v2/project/44056/admin/webhook

Réponses

Les informations sur les paramètres du webhook ont été reçues avec succès.

Corpsapplication/json
is_enabledboolean
Exemple: true
secretstring
Exemple: "my_secret"
urlstring
Exemple: "http://site.ru/webhook"
Réponse
application/json
{ "is_enabled": true, "secret": "my_secret", "url": "http://site.ru/webhook" }

Mettre à jour les informations sur les paramètres du webhookServer-sideAdmin

Requête

Récupère les informations sur les paramètres du webhook dans Store. Consultez la documentation sur les webhooks pour en savoir plus.

Sécurité
basicAuth
Chemin
project_idintegerobligatoire

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

Exemple: 44056
Corpsapplication/jsonobligatoire

Informations sur les paramètres du webhook.

is_enabledbooleanobligatoire

Détermine si les webhooks Game services sont activés.

Pour les webhooks Game services webhooks, le paramètre spécifié dans cet appel API a priorité sur celui configuré dans le Compte éditeur, dans la section Paramètres du projet > Webhooks.

Exemple: true
secretstringobligatoire

Clé secrète du projet pour la signature des webhooks Game services.

Pour Game services, la clé spécifiée dans cet appel API a priorité sur celle générée dans le Compte éditeur, dans la section Paramètres du projet > Webhooks.

Exemple: "my_secret_key"
urlstringobligatoire

URL de votre serveur pour la réception des webhooks Game services. L'URL doit être accessible au public et utiliser le protocole HTTPS, par exemple https://example.com. Vous pouvez également spécifier l'URL trouvée dans n'importe quel outil de test des webhooks.

Pour les webhooks Game services, le paramètre spécifié dans cet appel API a priorité sur celui configuré dans le Compte éditeur, dans la section Paramètres du projet > Webhooks.

Exemple: "http://site.ru/webhook"
versioninteger

Version des webhooks. Dans la version 2, le tableau d'objets inclut les paramètres is_free, is_bonus et is_bundle_content, qui ne sont pas présents dans la version 1 (par défaut).

Enum12
Exemple: 1
curl -i -X PUT \
  -u <username>:<password> \
  https://store.xsolla.com/api/v2/project/44056/admin/webhook \
  -H 'Content-Type: application/json' \
  -d '{
    "is_enabled": true,
    "secret": "my_secret_key",
    "url": "http://site.ru/webhook",
    "version": 1
  }'

Réponses

Les informations sur les paramètres du webhook ont été mises à jour avec succès.

Réponse
Aucun contenu
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