Vous cherchez la référence REST de service à service du Microsoft Store (collections, achat, récupération, octroi, récurrences)? Elle se trouve dans l’onglet API sous API REST du Microsoft Store.
Dans cette section
Prise en main
Vue d’ensemble, types de produits, configuration de Partner Center, tests, licences et dépannage.
Notions de base
Opérations de base du magasin, contenu téléchargeable, versions d’essai, consommables, ensembles, DWOB et mises à jour.
Gestion à partir de vos services
Authentification des services, requête des droits d’utilisation, abonnements, remboursements et ID User Store.
Considérations propres au PC
DRM, jetons de licence, gestion des comptes Store non concordants et changement de sandbox.
API REST du Microsoft Store
Référence des points de terminaison v8/v9 de collections, d’achat, de récupération, d’octroi et de récurrences. La référence complète se trouve maintenant dans l’onglet API sous API REST du Microsoft Store.
Hubs de franchise de jeux
Regroupez plusieurs produits sous un même hub de franchise dans le Store.
Vue d’ensemble : comment les éléments s’articulent
- Partner Center — où vous créez des produits (jeux de base, extensions, ensembles, passes de saison, abonnements, consommables), définissez les prix et la disponibilité, et attribuez des identificateurs (StoreId, Product ID, BigId, SKU ID).
MicrosoftGame.config— inclus dans le package de votre titre, il lie l’exécutable en cours d’exécution au produit du Store au moyen deTitleId,StoreIdetMSAAppId.- API d’exécution XStore (
XStore*) — appels côté client effectués par votre jeu pour énumérer les produits, interroger les licences et les droits d’utilisation, afficher l’interface d’achat et signaler le traitement des consommables. - API XPackage (
XPackage*) — montent les packages facultatifs (contenu téléchargeable) et en accordent la licence, installent des blocs et observent les changements d’état des packages. - API REST S2S du Microsoft Store — points de terminaison côté serveur que votre système principal appelle pour interroger de façon fiable les droits d’utilisation, traiter les consommables, accorder des produits, rechercher des abonnements et traiter les remboursements et récupérations.
- ID User Store (UserStoreId) — une clé de courte durée que votre titre obtient au moyen de
XUserGetTokenAndSignatureAsync(ou deXStoreGetUserCollectionsIdAsync/XStoreGetUserPurchaseIdAsync) et qu’il transmet à votre service afin que celui-ci puisse appeler le Store au nom de cet utilisateur.
Client ou service
Presque tous les scénarios du Store comportent à la fois un chemin côté client (XStore) et un chemin côté service (REST S2S). Utilisez le client pour l’expérience utilisateur en temps réel (afficher le bouton d’achat, déverrouiller du contenu, signaler une dépense de consommable); utilisez le service lorsque l’autorité compte (traiter une dépense de monnaie virtuelle qui doit survivre aux réinstallations du titre, accorder un article promotionnel, détecter Game Pass, traiter un remboursement). Un modèle fiable :- Le client détecte l’achat ou la dépense et affiche immédiatement l’expérience utilisateur.
- Le client envoie un UserStoreId à votre service.
- Le service appelle l’API S2S du Store pour confirmer le droit d’utilisation ou traiter le consommable, puis met à jour votre base de données de référence.