# API Shop Builder # 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 Por padrão, o Xsolla Login User JWT (Bearer token) é usado para autorização. Você pode tentar chamar esse ponto de extremidade com um token de testes Xsolla Login User JWT: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Você pode usar o [token de acesso Pay Station](https://developers.xsolla.com/pt/api/pay-station/operation/create-token/) como uma alternativa. Type: http Scheme: bearer Bearer Format: JWT ### basicAuth A Xsolla API usa autenticação de acesso básica. Todas as solicitações à API devem conter o cabeçalho `Authorization: Basic `, onde `your_authorization_basic_key` é o par codificado `project_id:api_key` de acordo com o padrão Base64. Você pode usar `merchant_id` em vez de `project_id` se precisar. Isso não afeta a funcionalidade. Vá para a [Conta de Distribuidor](https://publisher.xsolla.com/) para encontrar valores dos parâmetros: * `merchant_id` é mostrado: * Na seção **Configurações da empresa > Empresa** * Na URL na barra de endereço do navegador em qualquer página de conta de editor. O URL tem o seguinte formato: `https://publisher.xsolla.com/`. * `api_key` é exibida na Conta de Distribuidor apenas uma vez quando é criada e deve ser armazenada do seu lado. Você pode criar uma nova chave na seção a seguir: * **Configurações da empresa > Chaves API** * **Configurações do projeto > Chaves API** * `project_id` é mostrado: * Na Conta de Distribuidor ao lado do nome do projeto. * Na URL na barra de endereços do navegador ao trabalhar no projeto na Conta do Publicador. O URL tem o seguinte formato: `https://publisher.xsolla.com//projects/`. Para obter mais informações sobre como trabalhar com chaves API, consulte a [Referência de API](https://developers.xsolla.com/pt/api/getting-started/#api_keys_overview) . Type: http Scheme: basic ## Download OpenAPI description [API Shop Builder](https://developers.xsolla.com/_bundle/@l10n/pt/api/deprecated/inventory/index.yaml) ## Cliente ### Consumir item - [POST /v2/project/{project_id}/user/inventory/item/consume](https://developers.xsolla.com/pt/api/deprecated/inventory/inventory-client/consume-item.md): Ponto de extremidade do cliente. Consome um item do inventário do usuário atual. ### Obter o inventário do usuário atual - [GET /v2/project/{project_id}/user/inventory/items](https://developers.xsolla.com/pt/api/deprecated/inventory/inventory-client/get-user-inventory.md): Ponto de extremidade do cliente. Recupera o inventário do usuário atual. AtençãoTodos os projetos têm a limitação do número de itens que você pode obter na resposta. O valor padrão e máximo é de 50 itens por resposta. Para obter mais dados página por página, use os campos limit e offset. ### Obter itens de tempo limitado do usuário atual - [GET /v2/project/{project_id}/user/time_limited_items](https://developers.xsolla.com/pt/api/deprecated/inventory/inventory-client/get-user-subscriptions.md): Ponto de extremidade do cliente. Recupera os itens de tempo limitado do usuário atual. ### Obter o saldo virtual do usuário atual - [GET /v2/project/{project_id}/user/virtual_currency_balance](https://developers.xsolla.com/pt/api/deprecated/inventory/inventory-client/get-user-virtual-balance.md): Ponto de extremidade do cliente. Recupera o saldo virtual do usuário atual. ## Gestão ### Conceder itens por compras aos usuários - [POST /v2/project/{project_id}/inventory/purchase](https://developers.xsolla.com/pt/api/deprecated/inventory/inventory-management/grant-item-by-purchase.md): Adiciona os itens especificados por compra aos inventários de usuários especificados. AtençãoApenas 50 operações podem ser processadas de uma só vez. As operações que excederem esse limite serão ignoradas. ### Revogar itens de inventário - [POST /v2/project/{project_id}/inventory/revoke](https://developers.xsolla.com/pt/api/deprecated/inventory/inventory-management/revoke-item.md): Revoga o acesso a itens de vários usuários. AtençãoApenas 50 operações podem ser processadas de uma só vez. As operações que excederem esse limite serão ignoradas. ### Conceder itens aos usuários - [POST /v2/project/{project_id}/inventory/reward](https://developers.xsolla.com/pt/api/deprecated/inventory/inventory-management/add-item-to-inventory.md): Adiciona os itens especificados aos inventários de usuários especificados. AtençãoApenas 50 operações podem ser processadas de uma só vez. As operações que excederem esse limite serão ignoradas. ### Definir itens para usuários - [POST /v2/project/{project_id}/inventory/set](https://developers.xsolla.com/pt/api/deprecated/inventory/inventory-management/set-item-quantity.md): Define itens especificados para inventários de usuários especificados. Observe que os novos dados substituirão os dados antigos. AtençãoApenas 50 operações podem ser processadas de uma só vez. As operações que excederem esse limite serão ignoradas. ## Inventário multiplataforma ### Conecte a conta do jogo à Xsolla - [POST /v2/project/{project_id}/inventory/account/link](https://developers.xsolla.com/pt/api/deprecated/inventory/cross-inventory/inventory-account-link.md): Conecta a conta de jogo do usuário com a conta Xsolla. ### Tokenização de usuário - [POST /v2/project/{project_id}/inventory/account/signin](https://developers.xsolla.com/pt/api/deprecated/inventory/cross-inventory/inventory-account-signin.md): Obtém JWT para trabalhar com a Shop Builder API para usuários da sua plataforma de distribuição.