# Catalog 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 Catalog API fournit des endpoints pour gérer le catalogue de votre boutique en jeu et traiter les achats. Utilisez les endpoints pour configurer des objets virtuels, des monnaies virtuelles, des clés de jeu, des lots, des flux de panier et de paiement, des attributs d'articles et pour importer des articles depuis des sources externes. Version: 2.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForCart Lors de la vente d'un panier contenant des jeux, vous pouvez [appeler l'endpoint sans autorisation](/fr/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users). Pour ce faire: * Ajoutez un identifiant unique au paramètre `x-unauthorized-id` dans l'en-tête pour les jeux. * Ajoutez l'adresse e-mail de l'utilisateur au paramètre `x-user` (encodé en Base64) dans l'en-tête des jeux. 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 ### 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 de Xsolla utilise une authentification d'accès de base. Toutes les requêtes à 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` s'affiche : * Dans la section **Company settings > Company** ; * Dans l'URL dans la barre d'adresse du navigateur sur n'importe quelle page du Compte éditeur. L'URL présente le format suivant : `https://publisher.xsolla.com/`. * `api_key` apparaît dans le Compte éditeur une seule fois lors de sa création. Elle doit être conservée de votre côté. Vous pouvez créer une nouvelle clé dans la section suivante : * **Company settings > API keys** ; * **Project settings > API keys**. * `project_id` s'affiche : * Dans le Compte é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 éditeur. L'URL présente le format suivant : `https://publisher.xsolla.com//projets/`. Pour plus d'informations sur l'utilisation des clés API, voir la [référence API](https://developers.xsolla.com/fr/api/getting-started/#api_keys_overview). Type: http Scheme: basic ### basicMerchantAuth L'API de Xsolla utilise une authentification d'accès de base. Toutes les requêtes à l'API doivent contenir l'en-tête `Authorization: Basic `, où `your_authorization_basic_key` est la paire `merchant_id:api_key` encodée en Base64. Accédez au [Compte éditeur](https://publisher.xsolla.com/) pour trouver les valeurs des paramètres : * `merchant_id` s'affiche : * Dans la section **Company settings > Company** ; * Dans l'URL dans la barre d'adresse du navigateur sur n'importe quelle page du Compte éditeur. L'URL présente le format suivant : `https://publisher.xsolla.com/`. * `api_key` apparaît dans le Compte éditeur une seule fois lors de sa création. Elle doit être conservée de votre côté. Vous pouvez créer une nouvelle clé dans la section suivante : * **Company settings > API keys** ; * **Project settings > API keys**. Pour plus d'informations sur l'utilisation des clés API, voir la [référence API](https://developers.xsolla.com/fr/api/getting-started/#api_keys_overview). Type: http Scheme: basic ## Download OpenAPI description [Catalog API](https://developers.xsolla.com/_bundle/@l10n/fr/api/catalog/index.yaml) ## Administrateur ### Lire la liste des monnaies virtuelles - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-get-virtual-currencies-list.md): Récupère la liste des monnaies virtuelles au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Créer une monnaie virtuelle - [POST /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency.md): Crée une monnaie virtuelle. ### Lire la liste des packages de monnaie virtuelle (administrateur) - [GET /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency-packages-list.md): Récupère la liste des packages de monnaie virtuelle au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Créer un package de monnaie virtuelle - [POST /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency-package.md): Crée un package de monnaie virtuelle. ### Supprimer un package de monnaie virtuelle - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency-package.md): Supprime un package de monnaie virtuelle. ### Lire un package de monnaie virtuelle - [GET /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency-package.md): Récupère des informations sur un package de monnaie virtuelle au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Mettre à jour un package de monnaie virtuelle - [PUT /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency-package.md): Met à jour un package de monnaie virtuelle. ### Supprimer une monnaie virtuelle - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency.md): Supprime une monnaie virtuelle. ### Lire une monnaie virtuelle - [GET /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency.md): Récupère des informations sur une monnaie virtuelle au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Mettre à jour une monnaie virtuelle - [PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency.md): Met à jour une monnaie virtuelle. ### Lire la liste des objets virtuels - [GET /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list.md): Récupère la liste des objets virtuels au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Créer un objet virtuel - [POST /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-create-virtual-item.md): Crée un objet virtuel. ### Lire la liste des objets virtuels par external ID d'un groupe spécifique - [GET /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-external-id.md): Récupère la liste des objets virtuels au sein d'un groupe à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Lire la liste des objets virtuels par ID d'un groupe spécifique - [GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-id.md): Récupère la liste des objets virtuels au sein d'un groupe à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Supprimer un objet virtuel - [DELETE /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-delete-virtual-item.md): Supprime un objet virtuel. ### Lire un objet virtuel - [GET /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-get-virtual-item.md): Récupère des informations sur un objet virtuel au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Mettre à jour un objet virtuel - [PUT /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-admin/admin-update-virtual-item.md): Met à jour un objet virtuel. ## Catalogue ### Lire la liste des groupes d'objets - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-catalog/get-item-groups.md): Récupère une liste de groupes d'objets pour la constitution d'un catalogue. ### Lire une liste de monnaies virtuelles - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-catalog/get-virtual-currency.md): Récupère une liste de monnaies virtuelles pour la constitution d'un catalogue. 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. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire une liste de packages de monnaie virtuelle - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package.md): Récupère une liste de packages de monnaie virtuelle pour la constitution d'un catalogue. 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. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire un package de monnaie virtuelle par UGS - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package-sku.md): Récupère des informations sur un package de monnaie virtuelle par son UGS pour la constitution d'un catalogue. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ### Lire une monnaie virtuelle par UGS - [GET /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-catalog/get-virtual-currency-sku.md): Récupère des informations sur une monnaie virtuelle par son UGS pour la constitution d'un catalogue. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ### Lire une liste d'objets virtuels - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-catalog/get-virtual-items.md): Récupère une liste d'objets virtuels pour la constitution d'un catalogue. 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. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire la liste de tous les objets virtuels - [GET /v2/project/{project_id}/items/virtual_items/all](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-catalog/get-all-virtual-items.md): Récupère une liste de tous les objets virtuels à rechercher côté client. AttentionRenvoie uniquement l'UGS, le nom, les groupes et la description. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire une liste d'objets par groupe spécifique - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-catalog/get-virtual-items-group.md): Récupère une liste d'objets au sein d'un groupe spécifique pour la constitution d'un catalogue. 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. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation permet d'enrichir la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ### Lire un objet virtuel par UGS - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-items-currency-catalog/get-virtual-items-sku.md): Récupère des informations sur un objet virtuel par son UGS pour la constitution d'un catalogue. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ## Paiement virtuel ### Créer une commande à partir d'un objet spécifique en monnaie virtuelle - [POST /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}](https://developers.xsolla.com/fr/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency.md): Crée l'achat d'un objet en utilisant de la monnaie virtuelle. ## Catalogue ### Lire une liste de jeux - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/fr/api/catalog/game-keys-catalog/get-games-list.md): Récupère une liste de jeux pour la constitution d'un catalogue. 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. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire la liste des DRM - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/fr/api/catalog/game-keys-catalog/get-drm-list.md): Récupère la liste des DRM disponibles. ### Lire une liste de jeux par groupe spécifique - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/fr/api/catalog/game-keys-catalog/get-games-group.md): Récupère une liste de jeux à partir d'un groupe spécifié pour la constitution d'un catalogue. 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. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire une liste de clés de jeu par groupe spécifique - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/fr/api/catalog/game-keys-catalog/get-game-keys-group.md): Récupère une liste de clés de jeu à partir d'un groupe spécifié pour la constitution d'un catalogue. 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. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire une clé de jeu pour le catalogue - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/game-keys-catalog/get-game-key-by-sku.md): Récupère des informations sur une clé de jeu pour le catalogue. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ### Lire un jeu pour le catalogue - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/game-keys-catalog/get-game-by-sku.md): Récupère des informations sur un jeu pour le catalogue. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ## Droit ### Accorder un droit (administrateur) - [POST /v2/project/{project_id}/admin/entitlement/grant](https://developers.xsolla.com/fr/api/catalog/game-keys-entitlement/grant-entitlement-admin.md): Accorde un droit à l'utilisateur. AttentionSeuls les codes de jeu ou les jeux pour une plateforme sans DRM peuvent être accordés. ### Révoquer un droit (administrateur) - [POST /v2/project/{project_id}/admin/entitlement/revoke](https://developers.xsolla.com/fr/api/catalog/game-keys-entitlement/revoke-entitlement-admin.md): Retire les droits à l'utilisateur. AttentionSeuls les codes de jeu ou les jeux pour une plateforme sans DRM peuvent être retirés. ### Lire la liste des jeux qu'un utilisateur détient - [GET /v2/project/{project_id}/entitlement](https://developers.xsolla.com/fr/api/catalog/game-keys-entitlement/get-user-games.md): Récupère la liste des jeux que l'utilisateur détient. La réponse contiendra un tableau de jeux qu'un utilisateur spécifique détient. 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 10 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. ### Échanger un code de jeu côté client - [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/fr/api/catalog/game-keys-entitlement/redeem-game-pin-code.md): Accorde le droit associé au code de jeu fourni. AttentionSeuls les codes pour une plateforme sans DRM peuvent être échangés. ## Administrateur ### Lire la liste des jeux (administrateur) - [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-get-game-list.md): Récupère la liste des jeux au sein d'un projet à des fins d'administration. Le jeu consiste en des clés de jeu qui peuvent être achetées par un utilisateur. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Créer un jeu - [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-create-game.md): Crée un jeu dans le projet. ### Supprimer un jeu par ID - [DELETE /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-delete-game-by-id.md): Supprime un jeu du projet par son ID. ### Lire un jeu par ID (administrateur) - [GET /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-get-game-by-id.md): Récupère des informations sur un jeu au sein d'un projet à des fins d'administration. Le jeu consiste en des clés de jeu qui peuvent être achetées par un utilisateur. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Mettre à jour un jeu par ID - [PUT /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-update-game-by-id.md): Met à jour les informations d'un jeu dans le projet par son ID. ### Supprimer des codes par ID - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-delete-codes-by-id.md): Supprime tous les codes par ID de clé de jeu. ### Supprimer les codes - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-delete-codes-by-sku.md): Supprime tous les codes par UGS de clé de jeu. ### Lire des codes par ID - [GET /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-get-codes-by-id.md): Récupère un certain nombre de codes par ID de clé de jeu. ### Lire des codes - [GET /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-get-codes-by-sku.md): Récupère un certain nombre de codes par UGS de clé de jeu. ### Télécharger des codes par ID - [POST /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-upload-codes-by-id.md): Télécharge des codes par ID de clé de jeu. ### Lire des informations sur la session de chargement des codes - [GET /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-get-codes-session.md): Récupère des informations sur la session de chargement des codes. ### Télécharger des codes - [POST /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-upload-codes-by-sku.md): Télécharge des codes par UGS de clé de jeu. ### Supprimer un jeu par UGS - [DELETE /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-delete-game-by-sku.md): Supprime un jeu dans le projet par UGS. ### Lire un jeu (administrateur) - [GET /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-get-game-by-sku.md): Récupère des informations sur un jeu au sein d'un projet à des fins d'administration. Le jeu consiste en des clés de jeu qui peuvent être achetées par un utilisateur. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Mettre à jour un jeu par UGS - [PUT /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/game-keys-admin/admin-update-game-by-sku.md): Met à jour les informations d'un jeu dans le projet par UGS. ## Administrateur ### Lire une liste de lots - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/fr/api/catalog/bundles-admin/admin-get-bundle-list.md): Récupère la liste des lots au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Créer un lot - [POST /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/fr/api/catalog/bundles-admin/admin-create-bundle.md): Crée un lot. ### Lire la liste des lots par external ID d'un groupe spécifique - [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://developers.xsolla.com/fr/api/catalog/bundles-admin/admin-get-bundle-list-in-group-by-external-id.md): Récupère la liste des lots au sein d'un groupe à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Lire la liste des lots par ID d'un groupe spécifique - [GET /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}](https://developers.xsolla.com/fr/api/catalog/bundles-admin/admin-get-bundle-list-in-group-by-id.md): Récupère la liste des lots au sein d'un groupe à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Supprimer un lot - [DELETE /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/fr/api/catalog/bundles-admin/admin-delete-bundle.md): Supprime un lot. ### Lire un lot - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/fr/api/catalog/bundles-admin/admin-get-bundle.md): Récupère des informations sur un lot au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Mettre à jour un lot - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/fr/api/catalog/bundles-admin/admin-update-bundle.md): Met à jour un lot. ### Masquer un lot dans le catalogue - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://developers.xsolla.com/fr/api/catalog/bundles-admin/admin-hide-bundle.md): Masque un lot dans un catalogue. ### Afficher un lot dans le catalogue - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://developers.xsolla.com/fr/api/catalog/bundles-admin/admin-show-bundle.md): Affiche un lot dans un catalogue. ## Catalogue ### Lire une liste de lots - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/fr/api/catalog/bundles-catalog/get-bundle-list.md): Récupère une liste de lots pour la constitution d'un catalogue. 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 maximale est de 50 objets par réponse. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire une liste de lots par groupe spécifique - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://developers.xsolla.com/fr/api/catalog/bundles-catalog/get-bundle-list-in-group.md): Récupère une liste de lots dans un groupe pour la constitution d'un catalogue. 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 maximale est de 50 objets par réponse. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire un lot spécifique - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/fr/api/catalog/bundles-catalog/get-bundle.md): Récupère des informations sur un lot spécifique. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ## Panier (côté client) ### Lire le panier de l'utilisateur actuel - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/fr/api/catalog/cart-client-side/get-user-cart.md): Renvoie le panier de l'utilisateur actuel. ### Supprimer tous les objets du panier actuel - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/fr/api/catalog/cart-client-side/cart-clear.md): Supprime tous les objets du panier. ### Remplir le panier d'objets - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/fr/api/catalog/cart-client-side/cart-fill.md): Remplit d'objets le panier. Si le panier contient déjà un objet avec la même UGS, l'objet existant sera remplacé par la valeur passée. ### Supprimer un objet du panier actuel - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/fr/api/catalog/cart-client-side/delete-item.md): Supprime un objet du panier. ### Mettre à jour un objet du panier actuel - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/fr/api/catalog/cart-client-side/put-item.md): Met à jour un objet de panier existant ou en crée un nouveau dans le panier. ### Lire le panier par ID de panier - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/fr/api/catalog/cart-client-side/get-cart-by-id.md): Renvoie le panier de l'utilisateur par son ID de panier. ### Supprimer tous les objets du panier par ID de panier - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/fr/api/catalog/cart-client-side/cart-clear-by-id.md): Supprime tous les objets du panier. ### Remplir un panier spécifique d'objets - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/fr/api/catalog/cart-client-side/cart-fill-by-id.md): Remplit d'objets un panier spécifique. Si le panier contient déjà un objet avec la même UGS, l'objet existant sera remplacé par la valeur passée. ### Supprimer un objet du panier par ID de panier - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/fr/api/catalog/cart-client-side/delete-item-by-cart-id.md): Supprime un objet du panier. ### Mettre à jour un objet du panier par ID de panier - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/fr/api/catalog/cart-client-side/put-item-by-cart-id.md): Met à jour un objet de panier existant ou en crée un nouveau dans le panier. ## Panier (côté serveur) ### Remplir le panier d'objets - [PUT /v2/admin/project/{project_id}/cart/fill](https://developers.xsolla.com/fr/api/catalog/cart-server-side/admin-cart-fill.md): Remplit d'objets le panier actuel. Si le panier contient déjà un objet avec la même UGS, l'objet existant sera remplacé par la valeur passée. ### Remplir le panier d'objets par ID de panier - [PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/fr/api/catalog/cart-server-side/admin-fill-cart-by-id.md): Remplit d'objets le panier par son ID. Si le panier contient déjà un objet avec la même UGS, l'objet existant sera remplacé par la valeur passée. ## Paiement (côté client) ### Créer une commande à partir de tous les objets du panier actuel - [POST /v2/project/{project_id}/payment/cart](https://developers.xsolla.com/fr/api/catalog/payment-client-side/create-order.md): Utilisé pour l'intégration client-serveur. Crée une commande à partir de tous les objets du panier et génère un jeton de paiement pour cette commande. La commande créée aura le statut new. L'adresse IP du client est utilisée pour déterminer le pays de l'utilisateur, qui est ensuite utilisé pour appliquer la devise appropriée et les modes de paiement disponibles pour la commande. Pour ouvrir l'interface de paiement dans une nouvelle fenêtre, utilisez le lien suivant : https://secure.xsolla.com/paystation4/?token={token}, où {token} est le jeton reçu. À des fins de test, utilisez cette URL : https://sandbox-secure.xsolla.com/paystation4/?token={token}. Remarque Étant donné que cette méthode se base sur l'adresse IP pour déterminer le pays de l'utilisateur et sélectionner la devise de la commande, il est important de l'utiliser exclusivement côté client et non côté serveur. L'utilisation de cette méthode côté serveur pourrait entraîner une détermination incorrecte de la devise, ce qui pourrait affecter les modes de paiement dans Pay Station. ### Créer une commande à partir de tous les objets d'un panier spécifique - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://developers.xsolla.com/fr/api/catalog/payment-client-side/create-order-by-cart-id.md): Utilisé pour l'intégration client-serveur. Crée une commande à partir de tous les objets d'un panier spécifique et génère un jeton de paiement pour cette commande. La commande créée aura le statut new. L'adresse IP du client est utilisée pour déterminer le pays de l'utilisateur, qui est ensuite utilisé pour appliquer la devise appropriée et les modes de paiement disponibles pour la commande. Pour ouvrir l'interface de paiement dans une nouvelle fenêtre, utilisez le lien suivant : https://secure.xsolla.com/paystation4/?token={token}, où {token} est le jeton reçu. À des fins de test, utilisez cette URL : https://sandbox-secure.xsolla.com/paystation4/?token={token}. Remarque Étant donné que cette méthode se base sur l'adresse IP pour déterminer le pays de l'utilisateur et sélectionner la devise de la commande, il est important de l'utiliser exclusivement côté client et non côté serveur. L'utilisation de cette méthode côté serveur pourrait entraîner une détermination incorrecte de la devise, ce qui pourrait affecter les modes de paiement dans Pay Station. ### Créer une commande à partir d'un objet spécifique - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://developers.xsolla.com/fr/api/catalog/payment-client-side/create-order-with-item.md): Utilisé pour l'intégration client-serveur. Crée une commande à partir d'un objet spécifique et génère un jeton de paiement pour cette commande. La commande créée aura le statut new. L'adresse IP du client est utilisée pour déterminer le pays de l'utilisateur, qui est ensuite utilisé pour appliquer la devise appropriée et les modes de paiement disponibles pour la commande. Pour ouvrir l'interface de paiement dans une nouvelle fenêtre, utilisez le lien suivant : https://secure.xsolla.com/paystation4/?token={token}, où {token} est le jeton reçu. À des fins de test, utilisez cette URL : https://sandbox-secure.xsolla.com/paystation4/?token={token}. Remarque Étant donné que cette méthode se base sur l'adresse IP pour déterminer le pays de l'utilisateur et sélectionner la devise de la commande, il est important de l'utiliser exclusivement côté client et non côté serveur. L'utilisation de cette méthode côté serveur pourrait entraîner une détermination incorrecte de la devise, ce qui pourrait affecter les modes de paiement dans Pay Station. ## Paiement (côté serveur) ### Créer un jeton de paiement pour un achat - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/fr/api/catalog/payment-server-side/admin-create-payment-token.md): Génère une commande et un jeton de paiement pour celle-ci. La commande est générée sur la base des objets passés dans le corps de la requête. Pour ouvrir l'interface de paiement dans une nouvelle fenêtre, utilisez le lien suivant : https://secure.xsolla.com/paystation4/?token={token}, où {token} est le jeton reçu. À des fins de test, utilisez cette URL : https://sandbox-secure.xsolla.com/paystation4/?token={token}. Remarque Le paramètre user.country.value est utilisé pour sélectionner une devise pour la commande. Si le pays de l'utilisateur est inconnu, fournir l'adresse IP de l'utilisateur dans l'en-tête X-User-Ip est une option alternative. L'une de ces deux options est nécessaire au bon fonctionnement de cette méthode. La devise sélectionnée est utilisée pour les méthodes de paiement sur Pay Station. ## Commande ### Lire une commande - [GET /v2/project/{project_id}/order/{order_id}](https://developers.xsolla.com/fr/api/catalog/order/get-order.md): Récupère des informations sur une commande spécifique. ### Lire la liste des commandes pour la période spécifiée - [POST /v3/project/{project_id}/admin/order/search](https://developers.xsolla.com/fr/api/catalog/order/admin-order-search.md): Récupère la liste des commandes, triées par date de création dans un ordre croissant. ## Biens gratuits ### Créer une commande à partir d'un panier gratuit - [POST /v2/project/{project_id}/free/cart](https://developers.xsolla.com/fr/api/catalog/free-item/create-free-order.md): Crée une commande à partir de tous les objets d'un panier gratuit. La commande créée aura le statut done. ### Créer une commande à partir d'un panier gratuit spécifique - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://developers.xsolla.com/fr/api/catalog/free-item/create-free-order-by-cart-id.md): Crée une commande à partir de tous les biens d'un panier gratuit spécifique. La commande créée aura le statut done. ### Créer une commande à partir d'un bien gratuit spécifique - [POST /v2/project/{project_id}/free/item/{item_sku}](https://developers.xsolla.com/fr/api/catalog/free-item/create-free-order-with-item.md): Crée une commande à partir d'un bien gratuit spécifique. La commande créée aura le statut done. ## Gestion ### Actualiser toutes les limites d'achat pour un utilisateur spécifique - [DELETE /v2/project/{project_id}/admin/user/limit/item/all](https://developers.xsolla.com/fr/api/catalog/user-limits-admin/reset-all-user-items-limit.md): Actualise toutes les limites d'achat de tous les objets pour un utilisateur spécifique afin qu'il puisse à nouveau acheter ces objets. L'API des limites utilisateur vous permet de vendre un objet en quantité limitée. Pour configurer les limites d'achat, accédez à la section Administrateur du module du type d'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots ### Réduire le nombre d'objets offerts pour un utilisateur spécifique - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/user-limits-admin/remove-user-item-limit.md): Réduit le nombre restant d'objets offerts pour un utilisateur spécifique dans la limite appliquée. L'API des limites utilisateur vous permet de vendre un objet en quantité limitée. Pour configurer les limites d'achat, accédez à la section Administrateur du module du type d'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots ### Lire le nombre d'objets offerts pour un utilisateur spécifique - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/user-limits-admin/get-user-item-limit.md): Récupère le nombre restant d'objets disponibles pour un utilisateur spécifique dans la limite appliquée. L'API des limites utilisateur vous permet de vendre un objet en quantité limitée. Pour configurer les limites d'achat, accédez à la section Administrateur du module du type d'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots ### Augmenter le nombre d'objets offerts pour un utilisateur spécifique - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/user-limits-admin/add-user-item-limit.md): Augmente le nombre restant d'objets disponibles pour un utilisateur spécifique dans la limite appliquée. L'API des limites utilisateur vous permet de vendre un objet en quantité limitée. Pour configurer les limites d'achat, accédez à la section Administrateur du module du type d'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots ### Définir le nombre d'objets offerts pour un utilisateur spécifique - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/user-limits-admin/set-user-item-limit.md): Définit le nombre d'objets qu'un utilisateur spécifique peut acheter dans la limite appliquée après une augmentation ou une diminution. L'API des limites utilisateur vous permet de vendre un objet en quantité limitée. Pour configurer les limites d'achat, accédez à la section Administrateur du module du type d'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots ### Actualiser la limite d'achat - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/fr/api/catalog/user-limits-admin/reset-user-item-limit.md): Actualise les limites d'achat pour un objet afin que l'utilisateur puisse l'acheter à nouveau. Si le paramètre user est défini sur null, cet appel actualise ces limites pour tous les utilisateurs. L'API des limites utilisateur vous permet de vendre un objet en quantité limitée. Pour configurer les limites d'achat, accédez à la section Administrateur du module du type d'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots ## Administrateur ### Lire le statut de l'importation d'objets - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/fr/api/catalog/connector-admin/get-items-import-status.md): Récupère des informations sur la progression de l'importation d'objets dans le projet. Cet appel API récupère des données sur la dernière importation effectuée par le biais de l'API ou du Compte éditeur. ### Importer des objets via un fichier JSON - [POST /v1/projects/{project_id}/import/from_external_file](https://developers.xsolla.com/fr/api/catalog/connector-admin/import-items-from-external-file.md): Importe des objets dans le magasin à partir d'un fichier JSON via l'URL spécifiée. Pour plus d'informations, consultez la documentation. ## Webhooks ### Lire les informations sur les paramètres du webhook - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/fr/api/catalog/common-webhooks/get-webhook.md): Récupère les informations sur les paramètres du webhook dans Store. Consultez la documentation sur les webhooks pour en savoir plus. ### Mettre à jour les informations sur les paramètres du webhook - [PUT /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/fr/api/catalog/common-webhooks/update-webhook.md): Récupère les informations sur les paramètres du webhook dans Store. Consultez la documentation sur les webhooks pour en savoir plus. ## Pré-commandes ### Supprimer une quantité de la limite de pré-commande pour un objet - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/common-pre-orders/remove-pre-order-limit.md): Supprime une quantité de la limite de pré-commande pour un objet. L'API des limites de précommande vous permet de vendre un objet en quantité limitée. Pour configurer la pré-commande, accédez à la section Administrateur du module de l'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots Alias pour cet endpoint : * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Lire des informations sur la limite de pré-commande d'un objet - [GET /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/common-pre-orders/get-pre-order-limit.md): Récupère des information sur la limite de pré-commande pour un objet. L'API des limites de précommande vous permet de vendre un objet en quantité limitée. Pour configurer la pré-commande, accédez à la section Administrateur du module de l'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots Alias pour cet endpoint : * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Ajouter une quantité à la limite de pré-commande pour un objet - [POST /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/common-pre-orders/add-pre-order-limit.md): Ajoute une quantité à la limite de pré-commande pour un objet. L'API des limites de précommande vous permet de vendre un objet en quantité limitée. Pour configurer la pré-commande, accédez à la section Administrateur du module de l'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots Alias pour cet endpoint : * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Définir une quantité de la limite de pré-commande pour un objet - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/catalog/common-pre-orders/set-pre-order-limit.md): Définit une quantité de limite de pré-commande pour un objet. L'API des limites de précommande vous permet de vendre un objet en quantité limitée. Pour configurer la pré-commande, accédez à la section Administrateur du module de l'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots Alias pour cet endpoint : * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Supprimer toute la quantité de la limite de pré-commande pour un objet - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/fr/api/catalog/common-pre-orders/remove-all-pre-order-limit.md): Supprime toute la quantité de limite de pré-commande pour un objet. L'API des limites de précommande vous permet de vendre un objet en quantité limitée. Pour configurer la pré-commande, accédez à la section administrateur du module de l'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots Alias pour cet endpoint : * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Basculer la limite de pré-commande pour un objet - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://developers.xsolla.com/fr/api/catalog/common-pre-orders/toggle-pre-order-limit.md): Active/désactive la limite de pré-commande pour un objet. L'API des limites de précommande vous permet de vendre un objet en quantité limitée. Pour configurer la pré-commande, accédez à la section administrateur du module de l'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots Alias pour cet endpoint : * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ## Commerçant ### Lire les projets - [GET /v2/merchant/{merchant_id}/projects](https://developers.xsolla.com/fr/api/catalog/common-merchant/get-projects.md): Récupère la liste des projets du commerçant. RemarqueCet appel API ne contient pas le paramètre de chemin project_id, vous devez donc utiliser la clé API valide dans tous les projets de l'entreprise pour configurer l'autorisation. ## Catalogue Cette API permet de récupérer tout type d'objet vendable ou tout objet spécifique. ### Lire une liste d'objets vendables - [GET /v2/project/{project_id}/items](https://developers.xsolla.com/fr/api/catalog/common-catalog/get-sellable-items.md): Récupère une liste d'objets vendables pour la constitution d'un catalogue. 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. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire une liste d'objets vendables par groupe spécifique - [GET /v2/project/{project_id}/items/group/{external_id}](https://developers.xsolla.com/fr/api/catalog/common-catalog/get-sellable-items-group.md): Récupère une liste d'objets vendables à partir d'un groupe spécifié pour la constitution d'un catalogue. 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. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire un objet vendable par ID - [GET /v2/project/{project_id}/items/id/{item_id}](https://developers.xsolla.com/fr/api/catalog/common-catalog/get-sellable-item-by-id.md): Récupère des informations sur un objet vendable par son ID. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ### Lire un objet vendable par UGS - [GET /v2/project/{project_id}/items/sku/{sku}](https://developers.xsolla.com/fr/api/catalog/common-catalog/get-sellable-item-by-sku.md): Récupère des informations sur un objet vendable par son UGS pour la constitution d'un catalogue. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ## Régions communes ### Lire la liste des régions - [GET /v2/project/{project_id}/admin/region](https://developers.xsolla.com/fr/api/catalog/common-regions/admin-get-regions.md): Récupère la liste des régions. Utilisez les régions pour gérer les restrictions régionales. ### Créer une région - [POST /v2/project/{project_id}/admin/region](https://developers.xsolla.com/fr/api/catalog/common-regions/admin-create-region.md): Crée une région. Utilisez les régions pour gérer les restrictions régionales. ### Supprimer une région - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/fr/api/catalog/common-regions/admin-delete-region.md): Supprime une région spécifique. ### Lire une région - [GET /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/fr/api/catalog/common-regions/admin-get-region.md): Récupère des informations sur une région spécifique. Utilisez les régions pour gérer les restrictions régionales. ### Mettre à jour une région - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/fr/api/catalog/common-regions/admin-update-region.md): Met à jour les informations sur une région spécifique. Utilisez les régions pour gérer les restrictions régionales. ## Administrateur ### Lire la liste des attributs (administrateur) - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/fr/api/catalog/attribute-admin/admin-get-attribute-list.md): Récupère la liste des attributs au sein d'un projet à des fins d'administration. ### Créer un attribut - [POST /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/fr/api/catalog/attribute-admin/admin-create-attribute.md): Crée un attribut. ### Supprimer un attribut - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/fr/api/catalog/attribute-admin/delete-attribute.md): Supprime un attribut. NoteSi vous supprimez un attribut de bien, toutes ses données et connexions avec les objets seront perdues. ### Lire un attribut spécifique - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/fr/api/catalog/attribute-admin/admin-get-attribute.md): Récupère des informations sur un attribut spécifique. ### Mettre à jour un attribut - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/fr/api/catalog/attribute-admin/admin-update-attribute.md): Met à jour un attribut. ### Supprimer toutes les valeurs d'un attribut - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/fr/api/catalog/attribute-admin/admin-delete-all-attribute-value.md): Supprime toutes les valeurs de l'attribut. NoteSi vous supprimez la valeur d'un attribut, toutes les connexions entre cet attribut et les objets seront perdues. Pour modifier la valeur de l'attribut de bien, utilisez l'appel API Mettre à jour une valeur d'attribut au lieu de supprimer la valeur et d'en créer une nouvelle. ### Créer une valeur d'attribut - [POST /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/fr/api/catalog/attribute-admin/admin-create-attribute-value.md): Crée une valeur d'attribut. AttentionTous les projets sont soumis à une limite du nombre de valeurs d'attribut. La valeur par défaut et la valeur maximale sont de 20 valeurs par attribut. ### Supprimer une valeur d'attribut - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/fr/api/catalog/attribute-admin/admin-delete-attribute-value.md): Supprime une valeur de l'attribut. NoteSi vous supprimez la valeur d'un attribut, toutes les connexions entre cet attribut et les objets seront perdues. Pour modifier la valeur de l'attribut de bien, utilisez l'appel API Mettre à jour une valeur d'attribut au lieu de supprimer la valeur et d'en créer une nouvelle. ### Mettre à jour une valeur d'attribut - [PUT /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/fr/api/catalog/attribute-admin/admin-update-attribute-value.md): Met à jour les valeurs d'un attribut.