# 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 fornece endpoints para gerenciar o catálogo da sua loja no jogo e processar compras. Use os endpoints para configurar itens virtuais, moedas virtuais, chaves do jogo, conjuntos, fluxos de carrinho e pagamento, atributos de itens e importar itens de fontes externas. Version: 2.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForCart Ao vender um carrinho com jogos, você pode [chamar o ponto de extremidade sem autorização](/pt/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users). Para fazer isso: * Adicione um identificador exclusivo ao parâmetro `x-unauthorized-id` no cabeçalho dos jogos. * Adicione o e-mail do usuário ao parâmetro `x-user` (codificado em Base64) no cabeçalho dos jogos. 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 ### 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 ### basicMerchantAuth 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 `merchant_id:api_key` de acordo com o padrão Base64. 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** 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 [Catalog API](https://developers.xsolla.com/_bundle/@l10n/pt/api/catalog/index.yaml) ## Admin ### Obter lista de moedas virtuais - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-get-virtual-currencies-list.md): Obtém a lista de moedas virtuais dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Criar moeda virtual - [POST /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency.md): Cria uma moeda virtual. ### Obter lista de pacotes de moedas virtuais (admin) - [GET /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency-packages-list.md): Obtém a lista de pacotes de moedas virtuais dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Criar pacote de moedas virtuais - [POST /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency-package.md): Cria um pacote de moedas virtuais. ### Excluir pacote de moedas virtuais - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency-package.md): Exclui um pacote de moedas virtuais. ### Obter pacote de moedas virtuais - [GET /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency-package.md): Obtém o pacote de moedas virtuais dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Atualizar pacote de moedas virtuais - [PUT /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency-package.md): Atualiza um pacote de moedas virtuais. ### Excluir moeda virtual - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency.md): Exclui uma moeda virtual. ### Obter moeda virtual - [GET /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency.md): Obtém a moeda virtual dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Atualizar moeda virtual - [PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency.md): Atualiza uma moeda virtual. ### Obter lista de itens virtuais - [GET /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list.md): Obtém a lista de itens virtuais dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Criar item virtual - [POST /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-create-virtual-item.md): Cria um item virtual. ### Obter lista de itens virtuais por ID de grupo especificado externo - [GET /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-external-id.md): Obtém a lista de itens virtuais dentro de um grupo para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Obter lista de itens virtuais por ID de grupo especificado - [GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-id.md): Obtém a lista de itens virtuais dentro de um grupo para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Excluir item virtual - [DELETE /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-delete-virtual-item.md): Exclui um item virtual. ### Obter item virtual - [GET /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-get-virtual-item.md): Obtém o item virtual dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Atualizar item virtual - [PUT /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-admin/admin-update-virtual-item.md): Atualiza um item virtual. ## Catálogo ### Obter lista de grupo de itens - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-catalog/get-item-groups.md): Obtém uma lista de grupo 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/catalog/virtual-items-currency-catalog/get-virtual-currency.md): Recebe uma lista de moedas virtuais para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter lista de pacotes de moedas virtuais - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package.md): Recebe uma lista de pacotes de moedas virtuais para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter pacote de moedas virtuais por SKU - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package-sku.md): Obtém pacotes de moedas virtuais por SKU para criar um catálogo. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ### Obter moeda virtual por SKU - [GET /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-catalog/get-virtual-currency-sku.md): Obtém uma moeda virtual por SKU para criar um catálogo. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ### Obter lista de itens virtuais - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-catalog/get-virtual-items.md): Recebe uma lista de itens virtuais para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter toda a lista de itens virtuais - [GET /v2/project/{project_id}/items/virtual_items/all](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-catalog/get-all-virtual-items.md): Obtém uma lista de todos os itens virtuais para pesquisar no lado do cliente. Atençãoretorna apenas o SKU, nome, grupos e descrição do item ObservaçãoO uso das chamadas API do catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho de Autorização. ### Obter lista de itens por grupo especificado - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-catalog/get-virtual-items-group.md): Obtém uma lista de itens do grupo especificado para criar um catálogo. 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. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuário disponíveis e promoções. ### Obter item virtual por SKU - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-catalog/get-virtual-items-sku.md): Obtém um item virtual por SKU para criar um catálogo. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ## Pagamento virtual ### Criar pedido com item especificado comprado por moeda virtual - [POST /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}](https://developers.xsolla.com/pt/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency.md): Cria compra de item usando moeda virtual. ## Catálogo ### Obter lista de jogos - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/pt/api/catalog/game-keys-catalog/get-games-list.md): Recebe uma lista de jogos para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter lista de DRM - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/pt/api/catalog/game-keys-catalog/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/catalog/game-keys-catalog/get-games-group.md): Recebe uma lista de jogos do grupo especificado para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### 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/catalog/game-keys-catalog/get-game-keys-group.md): Recebe uma lista de chaves de jogo do grupo especificado para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter chave de jogo para catálogo - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/game-keys-catalog/get-game-key-by-sku.md): Obtém uma chave de jogo para o catálogo. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ### Obter jogo para catálogo - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/game-keys-catalog/get-game-by-sku.md): Obtém um jogo para o catálogo. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ## Direito ### Direito à concessão (admin) - [POST /v2/project/{project_id}/admin/entitlement/grant](https://developers.xsolla.com/pt/api/catalog/game-keys-entitlement/grant-entitlement-admin.md): Concede direito ao usuário. AtençãoCódigos de jogos ou jogos para plataformas sem DRM podem ser apenas concedidos. ### Revogar direito (admin) - [POST /v2/project/{project_id}/admin/entitlement/revoke](https://developers.xsolla.com/pt/api/catalog/game-keys-entitlement/revoke-entitlement-admin.md): Revoga o direito do usuário. AtençãoCódigos de jogos ou jogos para plataformas sem DRM podem ser apenas revogados. ### Obter lista de jogos de propriedade do usuário - [GET /v2/project/{project_id}/entitlement](https://developers.xsolla.com/pt/api/catalog/game-keys-entitlement/get-user-games.md): Obtenha a lista de jogos de propriedade do usuário. A resposta conterá uma matriz de jogos de propriedade de um usuário específico. AtençãoTodos os projetos têm uma 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. ### Resgatar código de jogo por cliente - [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/pt/api/catalog/game-keys-entitlement/redeem-game-pin-code.md): Concede o direito por um código de jogo fornecido. AtençãoVocê pode resgatar códigos apenas para a plataforma sem DRM. ## Admin ### Obter lista de jogos (admin) - [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-get-game-list.md): Obtém a lista de jogos dentro de um projeto para administração. O jogo consiste em chaves de jogo que podem ser compradas por um usuário. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de armazenamento. ### Criar jogo - [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-create-game.md): Cria um jogo no projeto. ### Excluir jogo por ID - [DELETE /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-delete-game-by-id.md): Exclui um jogo no projeto por ID. ### Obter jogo por ID (admin) - [GET /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-get-game-by-id.md): Recebe um jogo para administração. O jogo consiste em chaves de jogo que podem ser compradas por um usuário. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de armazenamento. ### Atualizar jogo por ID - [PUT /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-update-game-by-id.md): Atualiza um jogo no projeto por ID. ### Excluir códigos por ID - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-delete-codes-by-id.md): Exclui todos os códigos por ID de chave de jogo. ### Excluir códigos - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-delete-codes-by-sku.md): Exclui todos os códigos por SKU de chave de jogo. ### Obter códigos por ID - [GET /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-get-codes-by-id.md): Obtém um certo número de códigos por ID de chave de jogo. ### Obter códigos - [GET /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-get-codes-by-sku.md): Obtém um certo número de códigos por SKU de chave de jogo. ### Carregar códigos por ID - [POST /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-upload-codes-by-id.md): Carrega códigos por ID de chave de jogo. ### Obter códigos carregando informações da sessão - [GET /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-get-codes-session.md): Obtém códigos carregando informações de sessão. ### Carregar códigos - [POST /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-upload-codes-by-sku.md): Carrega códigos por SKU de chave de jogo. ### Excluir jogo por SKU - [DELETE /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-delete-game-by-sku.md): Exclui um jogo no projeto por SKU. ### Obter jogo (admin) - [GET /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-get-game-by-sku.md): Recebe um jogo para administração. O jogo consiste em chaves de jogo que podem ser compradas por um usuário. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de armazenamento. ### Atualizar jogo por SKU - [PUT /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/game-keys-admin/admin-update-game-by-sku.md): Atualiza um jogo no projeto por SKU. ## Admin ### Obter lista de pacotes - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/pt/api/catalog/bundles-admin/admin-get-bundle-list.md): Obtém a lista de pacotes dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de armazenamento. ### Criar conjunto - [POST /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/pt/api/catalog/bundles-admin/admin-create-bundle.md): Cria um conjunto. ### Obter lista de conjuntos por ID de grupo externo especificado - [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://developers.xsolla.com/pt/api/catalog/bundles-admin/admin-get-bundle-list-in-group-by-external-id.md): Obtém a lista de conjuntos dentro de um grupo para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Obter lista de conjuntos por ID de grupo especificado - [GET /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}](https://developers.xsolla.com/pt/api/catalog/bundles-admin/admin-get-bundle-list-in-group-by-id.md): Obtém a lista de conjuntos dentro de um grupo para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Excluir conjunto - [DELETE /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/pt/api/catalog/bundles-admin/admin-delete-bundle.md): Exclui um conjunto. ### Obter conjunto - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/pt/api/catalog/bundles-admin/admin-get-bundle.md): Obtém o conjunto dentro de um projeto para administração. ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. ### Conjunto de atualização - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/pt/api/catalog/bundles-admin/admin-update-bundle.md): Atualiza um conjunto. ### Ocultar conjunto no catálogo - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://developers.xsolla.com/pt/api/catalog/bundles-admin/admin-hide-bundle.md): Oculta um conjunto em um catálogo. ### Mostrar conjunto no catálogo - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://developers.xsolla.com/pt/api/catalog/bundles-admin/admin-show-bundle.md): Mostra um conjunto em um catálogo. ## Catálogo ### Obter lista de pacotes - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/pt/api/catalog/bundles-catalog/get-bundle-list.md): Recebe uma lista de conjuntos para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber na resposta. O valor padrão e máximo é de 50 itens por resposta. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter lista de pacotes por grupo especificado - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://developers.xsolla.com/pt/api/catalog/bundles-catalog/get-bundle-list-in-group.md): Recebe uma lista de conjuntos dentro de um grupo para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber na resposta. O valor padrão e máximo é de 50 itens por resposta. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter pacote especificado - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/pt/api/catalog/bundles-catalog/get-bundle.md): Obtém um conjunto especificado. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ## Carrinho (lado do cliente) ### Obter o carrinho do usuário atual - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/pt/api/catalog/cart-client-side/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/catalog/cart-client-side/cart-clear.md): Exclui todos os itens do carrinho. ### Preencher o carrinho com itens - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/pt/api/catalog/cart-client-side/cart-fill.md): Preenche 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/catalog/cart-client-side/delete-item.md): Remove um item do carrinho. ### Atualizar item do carrinho do carrinho atual - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/pt/api/catalog/cart-client-side/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/catalog/cart-client-side/get-cart-by-id.md): Devolve o carrinho do utilizador pelo ID de carrinho. ### Excluir todos os itens do carrinho pelo ID de carrinho - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/pt/api/catalog/cart-client-side/cart-clear-by-id.md): Exclui todos os itens do carrinho. ### Preencha o carrinho específico com itens - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/pt/api/catalog/cart-client-side/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/catalog/cart-client-side/delete-item-by-cart-id.md): Remove um item do carrinho. ### Atualizar item do carrinho por ID de carrinho - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/pt/api/catalog/cart-client-side/put-item-by-cart-id.md): Atualiza um item de carrinho existente ou cria o item no carrinho. ## Carrinho (lado do servidor) ### Preencher o carrinho com itens - [PUT /v2/admin/project/{project_id}/cart/fill](https://developers.xsolla.com/pt/api/catalog/cart-server-side/admin-cart-fill.md): Preenche o carrinho atual com itens. Se o carrinho já tiver um item com o mesmo SKU, o item existente será substituído pelo valor passado. ### Preencha o ID do carrinho pelo carrinho com itens - [PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/pt/api/catalog/cart-server-side/admin-fill-cart-by-id.md): Preenche o carrinho por ID de carrinho com itens. Se o carrinho já tiver um item com o mesmo SKU, o item existente será substituído pelo valor passado. ## Pagamento (lado do cliente) ### Criar pedido com todos os itens do carrinho atual - [POST /v2/project/{project_id}/payment/cart](https://developers.xsolla.com/pt/api/catalog/payment-client-side/create-order.md): Usado para a integração cliente-servidor. Cria um pedido com todos os itens do carrinho e gera um token de pagamento para ele. O pedido criado obtém o status do pedido new. O IP do cliente é usado para determinar o país do usuário, que é usado para aplicar a moeda correspondente e os métodos de pagamento disponíveis para o pedido. Para abrir a interface de pagamento em uma nova janela, use o seguinte link: https://secure.xsolla.com/paystation4/?token={token}, onde {token} é o token recebido. Para fins de teste, use este URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Como esse método usa o IP para determinar o país do usuário e selecionar uma moeda para o pedido, é importante usar esse método apenas do lado do cliente e não do lado do servidor. Usar esse método do lado do servidor pode causar determinação incorreta da moeda e afetar os métodos de pagamento no Pay Station. ### Criar pedido com todos os itens de um carrinho específico - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://developers.xsolla.com/pt/api/catalog/payment-client-side/create-order-by-cart-id.md): Usado para a integração cliente-servidor. Cria um pedido com todos os itens do carrinho em particular e gera um token de pagamento para ele. O pedido criado obtém o status do pedido new. O IP do cliente é usado para determinar o país do usuário, que é usado para aplicar a moeda correspondente e os métodos de pagamento disponíveis para o pedido. Para abrir a interface de pagamento em uma nova janela, use o seguinte link: https://secure.xsolla.com/paystation4/?token={token}, onde {token} é o token recebido. Para fins de teste, use este URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Como esse método usa o IP para determinar o país do usuário e selecionar uma moeda para o pedido, é importante usar esse método apenas do lado do cliente e não do lado do servidor. Usar esse método do lado do servidor pode causar determinação incorreta da moeda e afetar os métodos de pagamento no Pay Station. ### Criar pedido com item especificado - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://developers.xsolla.com/pt/api/catalog/payment-client-side/create-order-with-item.md): Usado para a integração cliente-servidor. Cria um pedido com um item especificado e gera um token de pagamento para ele. O pedido criado obtém o status do pedido new. O IP do cliente é usado para determinar o país do usuário, que é usado para aplicar a moeda correspondente e os métodos de pagamento disponíveis para o pedido. Para abrir a interface de pagamento em uma nova janela, use o seguinte link: https://secure.xsolla.com/paystation4/?token={token}, onde {token} é o token recebido. Para fins de teste, use este URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Como esse método usa o IP para determinar o país do usuário e selecionar uma moeda para o pedido, é importante usar esse método apenas do lado do cliente e não do lado do servidor. Usar esse método do lado do servidor pode causar determinação incorreta da moeda e afetar os métodos de pagamento no Pay Station. ## Pagamento (lado do servidor) ### Criar token de pagamento para compra - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/pt/api/catalog/payment-server-side/admin-create-payment-token.md): Gera um pedido e um token de pagamento para ele. O pedido é gerado com base nos itens passados no corpo da solicitação. Para abrir a interface de pagamento em uma nova janela, use o seguinte link: https://secure.xsolla.com/paystation4/?token={token}, onde {token} é o token recebido. Para propósitos de teste, use este URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso O parâmetro user.country.value é usado para selecionar uma moeda para o pedido. Se o país do usuário é desconhecido, fornecer o IP do usuário no cabeçalho X-User-Ip é uma opção alternativa. Uma dessas duas opções é necessária para o trabalho correto desse método. A moeda selecionada é usada para métodos de pagamento no Pay Station. ## Pedido ### Obter pedido - [GET /v2/project/{project_id}/order/{order_id}](https://developers.xsolla.com/pt/api/catalog/order/get-order.md): Recupera uma ordem especificada. ### Obter lista de pedidos para o período especificado - [POST /v3/project/{project_id}/admin/order/search](https://developers.xsolla.com/pt/api/catalog/order/admin-order-search.md): Recupera a lista de pedidos, organizada da data de criação mais antiga para a mais recente. ## Itens gratuitos ### Criar pedido com carrinho grátis - [POST /v2/project/{project_id}/free/cart](https://developers.xsolla.com/pt/api/catalog/free-item/create-free-order.md): Cria um pedido com todos os itens do carrinho gratuito. O pedido criado receberá um status de pedido done. ### Criar pedido com carrinho gratuito específico - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://developers.xsolla.com/pt/api/catalog/free-item/create-free-order-by-cart-id.md): Cria um pedido com todos os itens do carrinho gratuito específico. O pedido criado receberá um status de pedido done. ### Criar pedido com item gratuito especificado - [POST /v2/project/{project_id}/free/item/{item_sku}](https://developers.xsolla.com/pt/api/catalog/free-item/create-free-order-with-item.md): Cria um pedido com um item livre especificado. O pedido criado receberá um status de pedido done. ## Gestão ### Atualizar todos os limites de compra para o usuário especificado - [DELETE /v2/project/{project_id}/admin/user/limit/item/all](https://developers.xsolla.com/pt/api/catalog/user-limits-admin/reset-all-user-items-limit.md): Atualiza todos os limites de compra em todos os itens para um usuário especificado para que ele possa comprar esses itens novamente. A API User limit permite que você venda um item em uma quantidade limitada. Para configurar os limites de compra, vá para a seção Admin do módulo de tipo de item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos ### Diminuir o número de itens disponíveis para o usuário especificado - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/user-limits-admin/remove-user-item-limit.md): Diminui o número restante de itens disponíveis para o usuário especificado dentro do limite aplicado. A API User limit permite que você venda um item em uma quantidade limitada. Para configurar os limites de compra, vá para a seção Admin do módulo de tipo de item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos ### Obtenha o número de itens disponíveis para o usuário especificado - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/user-limits-admin/get-user-item-limit.md): Obtém o número restante de itens disponíveis para o usuário especificado dentro do limite aplicado. A API User limit permite que você venda um item em uma quantidade limitada. Para configurar os limites de compra, vá para a seção Admin do módulo de tipo de item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos ### Aumente o número de itens disponíveis para o usuário especificado - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/user-limits-admin/add-user-item-limit.md): Aumenta o número restante de itens disponíveis para o usuário especificado dentro do limite aplicado. A API User limit permite que você venda um item em uma quantidade limitada. Para configurar os limites de compra, vá para a seção Admin do módulo de tipo de item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos ### Defina o número de itens disponíveis para o usuário especificado - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/user-limits-admin/set-user-item-limit.md): Define o número de itens que o usuário especificado pode comprar dentro do limite aplicado depois que ele foi aumentado ou diminuído. A API User limit permite que você venda um item em uma quantidade limitada. Para configurar os limites de compra, vá para a seção Admin do módulo de tipo de item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos ### Atualizar limite de compra - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/pt/api/catalog/user-limits-admin/reset-user-item-limit.md): Atualiza o limite de compra de um item para que um usuário possa comprá-lo novamente. Se o parâmetro user for null, essa chamada atualizará esse limite para todos os usuários. A API User limit permite que você venda um item em uma quantidade limitada. Para configurar os limites de compra, vá para a seção Admin do módulo de tipo de item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos ## Admin ### Obter status da importação de itens - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/pt/api/catalog/connector-admin/get-items-import-status.md): Recupera informações sobre o andamento da importação de itens para o projeto. Essa chamada de API recupera dados da última importação realizada por meio da Conta de Distribuidor ou da API. ### Importar itens via arquivo JSON - [POST /v1/projects/{project_id}/import/from_external_file](https://developers.xsolla.com/pt/api/catalog/connector-admin/import-items-from-external-file.md): Importa itens para a Store a partir de um arquivo JSON por meio da URL especificada. Consulte a documentação para obter mais informações sobre a importação de um arquivo JSON. ## Webhooks ### Obter informações sobre as configurações do webhook - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/pt/api/catalog/common-webhooks/get-webhook.md): Obtém as informações sobre as configurações de webhook na Store. Consulte a documentação de webhooks para saber mais. ### Atualizar informações sobre as configurações do webhook - [PUT /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/pt/api/catalog/common-webhooks/update-webhook.md): Atualiza as informações sobre as configurações de webhook na Store. Consulte a documentação de webhooks para saber mais. ## Reservas ### Remover a quantidade de limite de pré-venda do item - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/common-pre-orders/remove-pre-order-limit.md): Remova a quantidade do limite de pré-venda do item. A API Pre-Order limit permite que você venda um item em uma quantidade limitada. Para configurar a pré-venda em si, vá para a seção Admin do módulo do item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos Aliases para este ponto de extremidade: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Obter informações sobre o limite de pré-venda de itens - [GET /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/common-pre-orders/get-pre-order-limit.md): Obtenha o limite de pré-venda do item. A API Pre-Order limit permite que você venda um item em uma quantidade limitada. Para configurar a pré-venda em si, vá para a seção Admin do módulo do item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos Aliases para este ponto de extremidade: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Adicionar quantidade ao limite de pré-venda do item - [POST /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/common-pre-orders/add-pre-order-limit.md): Adicione a quantidade ao limite de pré-venda do item. A API Pre-Order limit permite que você venda um item em uma quantidade limitada. Para configurar a pré-venda em si, vá para a seção Admin do módulo do item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos Aliases para este ponto de extremidade: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Definir o limite de pré-venda da quantidade de item - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/pt/api/catalog/common-pre-orders/set-pre-order-limit.md): Defina a quantidade do limite de pré-venda do item. A API Pre-Order limit permite que você venda um item em uma quantidade limitada. Para configurar a pré-venda em si, vá para a seção Admin do módulo do item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos Aliases para este ponto de extremidade: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Remover toda a quantidade de limite de pré-venda do item - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/pt/api/catalog/common-pre-orders/remove-all-pre-order-limit.md): Remova o limite de pré-venda do item. A API Pre-Order limit permite que você venda um item em uma quantidade limitada. Para configurar a pré-venda em si, vá para a seção admin do módulo do item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos Aliases para este ponto de extremidade: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/all ### Alternar o limite de pré-venda do item - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://developers.xsolla.com/pt/api/catalog/common-pre-orders/toggle-pre-order-limit.md): Ative/desative o limite de pré-venda do item. A API Pre-Order limit permite que você venda um item em uma quantidade limitada. Para configurar a pré-venda em si, vá para a seção admin do módulo do item desejado: * Chaves de Jogo * Itens e Moedas Virtuais * Conjuntos Aliases para este ponto de extremidade: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/toggle ## Comerciante ### Obter projetos - [GET /v2/merchant/{merchant_id}/projects](https://developers.xsolla.com/pt/api/catalog/common-merchant/get-projects.md): Obtém a lista de projetos do comerciante. AvisoEssa chamada de API não contém o trajeto de parâmetro project_id, portanto, você precisa usar a chave API que é válida em todos os projetos da empresa para configurar a autorização. ## Catálogo Esta API permite obter qualquer tipo de itens vendáveis ou itens específicos. ### Obter lista de itens vendáveis - [GET /v2/project/{project_id}/items](https://developers.xsolla.com/pt/api/catalog/common-catalog/get-sellable-items.md): Recebe uma lista de itens vendáveis para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter lista de itens vendáveis por grupo especificado - [GET /v2/project/{project_id}/items/group/{external_id}](https://developers.xsolla.com/pt/api/catalog/common-catalog/get-sellable-items-group.md): Recebe uma lista de itens vendáveis do grupo especificado para montar um catálogo. AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber 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. ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização. ### Obter item vendável por ID - [GET /v2/project/{project_id}/items/id/{item_id}](https://developers.xsolla.com/pt/api/catalog/common-catalog/get-sellable-item-by-id.md): Obtém um item comercializável por seu ID. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ### Obter item vendável por SKU - [GET /v2/project/{project_id}/items/sku/{sku}](https://developers.xsolla.com/pt/api/catalog/common-catalog/get-sellable-item-by-sku.md): Obtém um item vendável por SKU para criar um catálogo. ObservaçãoEsse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções. ## Regiões comuns ### Obter lista de regiões - [GET /v2/project/{project_id}/admin/region](https://developers.xsolla.com/pt/api/catalog/common-regions/admin-get-regions.md): Obtém lista de regiões. Você pode usar uma região para gerenciar suas restrições regionais. ### Criar região - [POST /v2/project/{project_id}/admin/region](https://developers.xsolla.com/pt/api/catalog/common-regions/admin-create-region.md): Cria região. Você pode usar uma região para gerenciar suas restrições regionais. ### Excluir região - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/pt/api/catalog/common-regions/admin-delete-region.md): Exclui uma região específica. ### Obter região - [GET /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/pt/api/catalog/common-regions/admin-get-region.md): Obtém região específica. Você pode usar uma região para gerenciar suas restrições regionais. ### Atualizar região - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/pt/api/catalog/common-regions/admin-update-region.md): Atualiza uma região específica. Você pode usar uma região para gerenciar suas restrições regionais. ## Admin ### Obter lista de atributos (admin) - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/pt/api/catalog/attribute-admin/admin-get-attribute-list.md): Obtém a lista de atributos de um projeto para administração. ### Criar atributo - [POST /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/pt/api/catalog/attribute-admin/admin-create-attribute.md): Cria um atributo. ### Excluir atributo - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/pt/api/catalog/attribute-admin/delete-attribute.md): Exclui um atributo. AvisoSe você excluir um atributo de item, todos os seus dados e conexões com itens serão perdidos. ### Obter atributo especificado - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/pt/api/catalog/attribute-admin/admin-get-attribute.md): Obtém um atributo especificado. ### Atualizar atributo - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/pt/api/catalog/attribute-admin/admin-update-attribute.md): Atualiza um atributo. ### Excluir todos os valores do atributo - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/pt/api/catalog/attribute-admin/admin-delete-all-attribute-value.md): Exclui todos os valores do atributo. AvisoSe você excluir o valor de um atributo, todas as conexões entre o atributo e os itens serão perdidas. Para alterar o valor do atributo de um item, use a chamada de API Atualizar valor do atributo em vez de excluir o valor e criar um novo. ### Criar valor de atributo - [POST /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/pt/api/catalog/attribute-admin/admin-create-attribute-value.md): Cria um valor de atributo. AtençãoTodos os projetos têm a limitação do número de valores de atributo. O valor padrão e máximo é de 20 valores por atributo. ### Excluir valor de atributo - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/pt/api/catalog/attribute-admin/admin-delete-attribute-value.md): Exclui um valor de atributo. AvisoSe você excluir o valor de um atributo, todas as conexões entre o atributo e os itens serão perdidas. Para alterar o valor do atributo de um item, use a chamada de API Atualizar valor do atributo em vez de excluir o valor e criar um novo. ### Atualizar valor do atributo - [PUT /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/pt/api/catalog/attribute-admin/admin-update-attribute-value.md): Atualiza os valores de um atributo.