# Shop Builder API # Overview * **Version:** 2.0.0 * **Servers**: `https://store.xsolla.com/api` * **[Contact Us by Email](mailto:integration@xsolla.com)** * **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. Version: 2.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### XsollaLoginUserJWT Par défaut, JWT utilisateur Xsolla Login (jeton Bearer) est utilisé pour l'autorisation. Vous pouvez essayer d'appeler cet endpoint avec un JWT utilisateur Xsolla Login de test : `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Vous pouvez également utiliser le [jeton d'accès Pay Station](https://developers.xsolla.com/fr/api/pay-station/operation/create-token/). Type: http Scheme: bearer Bearer Format: JWT ### basicAuth L'API Xsolla utilise une authentification d'accès de base. Toutes les requêtes adressées à l'API doivent contenir l'en-tête `Authorization: Basic `, où `your_authorization_basic_key` est la paire `project_id:api_key` encodée en Base64. Vous pouvez utiliser `merchant_id` au lieu de `project_id` si nécessaire. Cela n'affecte pas la fonctionnalité. Accédez au [Compte éditeur](https://publisher.xsolla.com/) pour trouver les valeurs des paramètres : * `merchant_id` est affichée : * Dans la section **Paramètres de l'entreprise > Entreprise** * Dans l'URL dans la barre d'adresse du navigateur sur n'importe quelle page du compte de l'éditeur. L'URL a le format suivant : `https://publisher.xsolla.com/`. * `api_key` n'apparaît dans le compte de l'éditeur qu'une seule fois lors de sa création et doit être stockée de votre côté. Vous pouvez créer une nouvelle clé dans la section suivante : * **Paramètres de l'entreprise > Clés API** * **Paramètres du projet > Clés API** * `project_id` est affichée : * Dans Compte de l'éditeur, à côté du nom du projet. * Dans l'URL dans la barre d'adresse du navigateur lorsque vous travaillez sur un projet dans le compte de l'éditeur. L'URL a le format suivant : `https://publisher.xsolla.com//projets/`. Pour plus d'informations sur l'utilisation des clés API, voir la [référence de l'API](https://developers.xsolla.com/fr/api/getting-started/#api_keys_overview). Type: http Scheme: basic ## Download OpenAPI description [Shop Builder API](https://developers.xsolla.com/_bundle/@l10n/fr/api/deprecated/inventory/index.yaml) ## Client ### Consommer un objet - [POST /v2/project/{project_id}/user/inventory/item/consume](https://developers.xsolla.com/fr/api/deprecated/inventory/inventory-client/consume-item.md): Endpoint client. Consomme un objet de l'inventaire actuel d'un utilisateur. ### Lire l'inventaire actuel de l'utilisateur - [GET /v2/project/{project_id}/user/inventory/items](https://developers.xsolla.com/fr/api/deprecated/inventory/inventory-client/get-user-inventory.md): Endpoint client. Récupère l'inventaire actuel de l'utilisateur. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. ### Lire les objets à durée limitée actuels d'un utilisateur - [GET /v2/project/{project_id}/user/time_limited_items](https://developers.xsolla.com/fr/api/deprecated/inventory/inventory-client/get-user-subscriptions.md): Endpoint client. Récupère les objets à durée limitée actuels d'un utilisateur. ### Lire le solde virtuel actuel de l'utilisateur - [GET /v2/project/{project_id}/user/virtual_currency_balance](https://developers.xsolla.com/fr/api/deprecated/inventory/inventory-client/get-user-virtual-balance.md): Endpoint client. Récupère le solde virtuel actuel de l'utilisateur. ## Gestion ### Octroyer des objets à des utilisateurs par achats - [POST /v2/project/{project_id}/inventory/purchase](https://developers.xsolla.com/fr/api/deprecated/inventory/inventory-management/grant-item-by-purchase.md): Ajoute des objets spécifiques aux inventaires des utilisateurs spécifiques en fonction de leurs achats. AttentionSeules 50 opérations peuvent être traitées à la fois. Les opérations qui dépassent cette limite seront ignorées. ### Révoquer des objets d'inventaire - [POST /v2/project/{project_id}/inventory/revoke](https://developers.xsolla.com/fr/api/deprecated/inventory/inventory-management/revoke-item.md): Révoque l'accès de plusieurs utilisateurs à des objets. AttentionSeules 50 opérations peuvent être traitées à la fois. Les opérations qui dépassent cette limite seront ignorées. ### Octroyer des objets à des utilisateurs - [POST /v2/project/{project_id}/inventory/reward](https://developers.xsolla.com/fr/api/deprecated/inventory/inventory-management/add-item-to-inventory.md): Ajoute des objets spécifiques aux inventaires des utilisateurs spécifiques. AttentionSeules 50 opérations peuvent être traitées à la fois. Les opérations qui dépassent cette limite seront ignorées. ### Définir des objets à des utilisateurs - [POST /v2/project/{project_id}/inventory/set](https://developers.xsolla.com/fr/api/deprecated/inventory/inventory-management/set-item-quantity.md): Définit des objets spécifiques aux inventaires des utilisateurs spécifiques. Notez que les nouvelles données remplaceront les anciennes données. AttentionSeules 50 opérations peuvent être traitées à la fois. Les opérations qui dépassent cette limite seront ignorées. ## Inventaire multiplateforme ### Connecter un compte de jeu à Xsolla - [POST /v2/project/{project_id}/inventory/account/link](https://developers.xsolla.com/fr/api/deprecated/inventory/cross-inventory/inventory-account-link.md): Connecte le compte de jeu de l'utilisateur à un compte Xsolla. ### Tokénisation de l'utilisateur - [POST /v2/project/{project_id}/inventory/account/signin](https://developers.xsolla.com/fr/api/deprecated/inventory/cross-inventory/inventory-account-signin.md): Récupère un JWT pour interagir avec Shop Builder API pour les utilisateurs de votre plateforme de publication.