# Digital Distribution Hub # Visão Geral Digital Distribution Hub é uma nova solução Xsolla que visa conectar pagamentos digitais e baseados em dinheiro através da tecnologia de pagamentos push e e-commerce. Essa referência combina pontos de extremidade de API para dois produtos Xsolla: [In-Game Store](https://developers.xsolla.com/pt/doc/in-game-store/) e [Pay Station](https://developers.xsolla.com/pt/doc/pay-station/). Há dois URLs base: * `https://store.xsolla.com/api` para os grupos **Common**, **Catalog**, **Cart** e **Order**. * `https://ps.xsolla.com` para o grupo **Notifications**. Os pontos de extremidade da API no grupo **Catalog** não exigem autorização. Para trabalhar com operações nos grupos **Cart** e **Order**, você precisa gerar um token via [Create user token](https://developers.xsolla.com/pt/digital-distribution-hub/common/user-token/create-user-token).
Observação

Esta referência mostra o design de uma API futura e não uma interface totalmente funcional. Atualmente, você pode experimentar apenas os pontos de extremidade dos grupos Catalog e Notifications. Se você quiser compartilhar seus comentários, envie um e-mail para techdoc@xsolla.com.
Version: 1.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForClient Use o ponto de extremidade [Create user token](https://developers.xsolla.com\/pt/api/digital-distribution-hub/operation/create-user-token) para gerar um token. Type: http Scheme: bearer ### 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 `distribution_hub_id:api_key` codificado de acordo com o padrão Base64. Entre em contato com seu Gerente da Conta para obter `distribution_hub_id` e `api_key`. Type: http Scheme: basic ## Download OpenAPI description [Digital Distribution Hub](https://developers.xsolla.com/_bundle/@l10n/pt/api/digital-distribution-hub/index.yaml) ## Carrinho ### Obter o carrinho do usuário atual - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/pt/api/digital-distribution-hub/cart/get-user-cart.md): Retorna o carrinho do usuário atual. ### Excluir todos os itens do carrinho atual - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/pt/api/digital-distribution-hub/cart/cart-clear.md): Exclui todos os itens do carrinho. ### Encher o carrinho com itens - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/pt/api/digital-distribution-hub/cart/cart-fill.md): Enche o carrinho de itens. Se o carrinho já tiver um item com o mesmo SKU, o item existente será substituído pelo valor passado. ### Excluir item do carrinho atual - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/pt/api/digital-distribution-hub/cart/delete-item.md): Remove um item do carrinho. ### Atualizar item de carrinho no carrinho atual - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/pt/api/digital-distribution-hub/cart/put-item.md): Atualiza um item de carrinho existente ou cria o item no carrinho. ### Obter carrinho por ID de carrinho - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/pt/api/digital-distribution-hub/cart/get-cart-by-id.md): Devolve o carrinho do usuário pelo ID do carrinho. ### Excluir todos os itens do carrinho pelo ID do carrinho - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/pt/api/digital-distribution-hub/cart/cart-clear-by-id.md): Exclui todos os itens do carrinho. ### Encher o carrinho específico com itens - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/pt/api/digital-distribution-hub/cart/cart-fill-by-id.md): Preenche o carrinho específico com itens. Se o carrinho já tiver um item com o mesmo SKU, a posição do item existente será substituída pelo valor passado. ### Excluir item de carrinho por ID de carrinho - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/pt/api/digital-distribution-hub/cart/delete-item-by-cart-id.md): Remove um item do carrinho. ### Atualizar item do carrinho por ID do carrinho - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/pt/api/digital-distribution-hub/cart/put-item-by-cart-id.md): Atualiza um item de carrinho existente ou cria o item no carrinho. ## Chaves de jogo ### Obter lista de jogos - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/pt/api/digital-distribution-hub/game-keys/get-games-list.md): Obtém uma lista de jogos para criar um catálogo. Atenção. Todos os projetos têm uma limitação no 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 lista de DRMs - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/pt/api/digital-distribution-hub/game-keys/get-drm-list.md): Obtém a lista de DRMs disponíveis. ### Obter lista de jogos por grupo especificado - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/pt/api/digital-distribution-hub/game-keys/get-games-group.md): Obtém uma lista de jogos do grupo especificado para criar um catálogo. Atenção. Todos os projetos têm uma limitação no 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 lista de chaves de jogo por grupo especificado - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/pt/api/digital-distribution-hub/game-keys/get-game-keys-group.md): Obtém uma lista de chaves de jogo do grupo especificado para criar um catálogo. Atenção. Todos os projetos têm uma limitação no 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 chave de jogo para catálogo - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/pt/api/digital-distribution-hub/game-keys/get-game-key-by-sku.md): Obtém uma chave de jogo para o catálogo. ### Obter jogo para catálogo - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/pt/api/digital-distribution-hub/game-keys/get-game-by-sku.md): Obtém um jogo para o catálogo. ## Itens virtuais e moeda ### Obter lista de grupos de itens - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/pt/api/digital-distribution-hub/virtual-items-and-currency/get-item-groups.md): Obtém uma lista de grupos de itens para criar um catálogo. ### Obter lista de moedas virtuais - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/pt/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-currency.md): Obtém uma lista de moedas virtuais para criar um catálogo. Atenção. Todos os projetos têm a limitação no 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 lista de pacotes de moedas virtuais - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/pt/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-currency-package.md): Obtém uma lista de pacotes de moedas virtuais para criar um catálogo. Atenção. Todos os projetos têm uma limitação no 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 lista de itens virtuais - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/pt/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-items.md): Obtém uma lista de itens virtuais para criar um catálogo. Atenção. Todos 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 lista de itens por grupo especificado - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/pt/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-items-group.md): Obtém uma lista de itens do grupo especificado para criar um catálogo. Atenção. Todos os projetos têm uma limitação no 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. ## Conjuntos ### Obter lista de conjuntos - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/pt/api/digital-distribution-hub/bundles/get-bundle-list.md): Obtém uma lista de conjuntos para criar um catálogo. Atenção. Todos 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. ### Obter conjunto especificado - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/pt/api/digital-distribution-hub/bundles/get-bundle.md): Obtém um conjunto especificado. ## Token de usuário ### Criar token de usuário - [POST /v2/project/{project_id}/distribution_hub/user/auth](https://developers.xsolla.com/pt/api/digital-distribution-hub/user-token/create-user-token.md): Verifica se um usuário existe no jogo e cria um token de usuário. ## Notificações ### Cancelar notificação - [POST /push-payments/cancel](https://developers.xsolla.com/pt/api/digital-distribution-hub/notifications/cancel-notification.md): Enviar a notificação sobre o cancelamento do pagamento se: - o pagamento não foi concluído - o pagamento foi reembolsado ### Notificação de pagamento - [POST /push-payments/pay](https://developers.xsolla.com/pt/api/digital-distribution-hub/notifications/pay-notification.md): Envie esta notificação depois de cobrar um usuário com êxito. ## Pedido ### Obter pedido - [GET /v2/project/{project_id}/distribution_hub/order/{order_id}](https://developers.xsolla.com/pt/api/digital-distribution-hub/order/get-order.md): Recupera um pedido especificado. ### Criar pedido com todos os itens do carrinho atual - [POST /v2/project/{project_id}/distribution_hub/payment/cart](https://developers.xsolla.com/pt/api/digital-distribution-hub/order/create-order.md): Cria um pedido com todos os itens do carrinho. O pedido criado receberá um status de pedido new. ### Criar pedido com todos os itens de um carrinho específico - [POST /v2/project/{project_id}/distribution_hub/payment/cart/{cart_id}](https://developers.xsolla.com/pt/api/digital-distribution-hub/order/create-order-by-cart-id.md): Cria um pedido com todos os itens do carrinho específico. O pedido criado receberá um status de pedido new. ### Criar pedido com item especificado - [POST /v2/project/{project_id}/distribution_hub/payment/item/{item_sku}](https://developers.xsolla.com/pt/api/digital-distribution-hub/order/create-order-with-item.md): Cria um pedido com um item especificado. O pedido criado receberá um status de pedido new.