Procurando a referência REST de serviço para serviço da Microsoft Store (coleções, compra, clawback, concessão, recorrências)? Ela está na guia API, em APIs REST da Microsoft Store.
Nesta seção
Introdução
Visão geral, tipos de produto, configuração do Partner Center, testes, licenciamento e solução de problemas.
Fundamentos
Operações básicas da loja, DLC, avaliações, consumíveis, pacotes, DWOB e atualizações.
Gerenciar a partir dos seus serviços
Autenticar serviços, consultar direitos, assinaturas, reembolsos e User Store IDs.
Considerações específicas do PC
DRM, tokens de licença, tratamento de contas da loja incompatíveis e troca de sandbox.
APIs REST da Microsoft Store
Referência para os pontos de extremidade v8/v9 de coleções, compra, clawback, concessão e recorrências. A referência completa agora está na guia API, em APIs REST da Microsoft Store.
Hubs de franquias de jogos
Agrupe vários produtos em um único hub de franquia da Store.
Visão geral: como as peças se conectam
- Partner Center — onde você cria produtos (jogos base, complementos, pacotes, passes de temporada, assinaturas, consumíveis), define preços e disponibilidade e atribui identificadores (StoreId, Product ID, BigId, SKU ID).
MicrosoftGame.config— é fornecido dentro do pacote do título e vincula o executável em execução ao produto da Store por meio deTitleId,StoreIdeMSAAppId.- APIs de tempo de execução XStore (
XStore*) — chamadas do lado do cliente feitas pelo jogo para enumerar produtos, consultar licenças e direitos, mostrar a interface de compra e relatar o atendimento de consumíveis. - APIs XPackage (
XPackage*) — montam e licenciam pacotes opcionais (DLC), instalam partes e observam alterações de estado dos pacotes. - APIs REST S2S da Microsoft Store — pontos de extremidade do lado do servidor que seu back-end chama para consultar direitos de forma autoritativa, atender consumíveis, conceder produtos, pesquisar assinaturas e processar reembolsos/clawbacks.
- User Store ID (UserStoreId) — uma chave de curta duração que o título obtém por meio de
XUserGetTokenAndSignatureAsync(ouXStoreGetUserCollectionsIdAsync/XStoreGetUserPurchaseIdAsync) e entrega ao seu serviço para que ele possa chamar a Store em nome desse usuário.
Cliente versus serviço
Quase todos os cenários da Store têm um caminho do lado do cliente (XStore) e um do lado do serviço (REST S2S). Use o cliente para a experiência do usuário em tempo real (mostrar o botão de compra, desbloquear conteúdo, relatar um gasto de consumível); use o serviço quando a autoridade importar (atender um gasto de moeda virtual que precisa sobreviver a reinstalações do título, conceder um item promocional, detectar o Game Pass, processar um reembolso). Um padrão confiável:- O cliente detecta a compra ou o gasto e mostra a experiência imediata.
- O cliente envia um UserStoreId ao seu serviço.
- O serviço chama a API S2S da Store para confirmar o direito ou atender o consumível e atualiza seu banco de dados de registro.