Saltar para o conteúdo

Overview

  • Version: 2.0.0
  • Servers: https://store.xsolla.com/api
  • Contact Us by Email
  • 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.

Transferir a descrição da OpenAPI
Idiomas
Servidores
Mock server
https://xsolla.redocly.app/_mock/pt/api/catalog/
https://store.xsolla.com/api/
Operações
Operações
Operações
Operações
Operações
Operações
Operações
Operações
Operações
Operações
Operações
Operações
Operações
Operações
Operações
Operações
Operações
Operações
Operações

Catálogo

Esta API permite obter qualquer tipo de itens vendáveis ou itens específicos.

Operações
Operações
Operações

Atualizar atributoServer-sideAdmin

Pedido

Atualiza um atributo.

Segurança
basicAuth
Caminho
project_idintegerobrigatório

ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

Exemplo: 44056
external_idstringobrigatório

ID externo de atributo.

Exemplo: attribute_id
Corpoapplication/json
external_idstring(admin-attribute-external_id)[ 1 .. 255 ] characters^[a-zA-Z0-9-_]+$obrigatório

ID de atributo exclusivo. O external_id só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, traços e sublinhados.

Exemplo: "attribute_1"
nameobject(admin-attribute-name)obrigatório

Objeto com localizações para o nome do atributo. As chaves são especificadas no formato ISO 3166-1.

Padrão {"de":"Genre","en":"Genre"}
Exemplo: {"de":"Genre","en":"Genre"}
name.​property name*stringpropriedade adicional
curl -i -X PUT \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/pt/api/catalog/v2/project/44056/admin/attribute/attribute_id \
  -H 'Content-Type: application/json' \
  -d '{
    "external_id": "genre",
    "name": {
      "de": "Genre",
      "en": "Genre"
    }
  }'

Respostas

Atributo atualizado com sucesso.

Corpo
Resposta
Sem conteúdo

Excluir todos os valores do atributoServer-sideAdmin

Pedido

Exclui todos os valores do atributo.

Aviso

Se 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.
Segurança
basicAuth
Caminho
project_idintegerobrigatório

ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

Exemplo: 44056
external_idstringobrigatório

ID externo de atributo.

Exemplo: attribute_id
curl -i -X DELETE \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/pt/api/catalog/v2/project/44056/admin/attribute/attribute_id/value

Respostas

Os valores de atributo foram excluídos com sucesso.

Resposta
Sem conteúdo

Criar valor de atributoServer-sideAdmin

Pedido

Cria um valor de atributo.

Atenção

Todos 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.
Segurança
basicAuth
Caminho
project_idintegerobrigatório

ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

Exemplo: 44056
external_idstringobrigatório

ID externo de atributo.

Exemplo: attribute_id
Corpoapplication/json
external_idstring(value-external_id)[ 1 .. 255 ] characters^[-_.\d\w]+$obrigatório

ID de valor exclusivo para um atributo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.

Exemplo: "attribute_value"
valueobject(value-name)obrigatório

Objeto com traduções do nome do valor. As chaves são especificadas no formato ISO 3166-1.

Padrão {"de":"Strategie","en":"Strategy"}
Exemplo: {"de":"Strategie","en":"Strategy"}
value.​property name*stringpropriedade adicional
curl -i -X POST \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/pt/api/catalog/v2/project/44056/admin/attribute/attribute_id/value \
  -H 'Content-Type: application/json' \
  -d '{
    "external_id": "weapon_class_sword_value",
    "value": {
      "de": "Schwert",
      "en": "Sword"
    }
  }'

Respostas

O valor do atributo foi criado com sucesso.

Corpoapplication/json
external_idstring(value-external_id)[ 1 .. 255 ] characters^[-_.\d\w]+$

ID de valor exclusivo para um atributo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.

Exemplo: "attribute_value"
Resposta
application/json
{ "external_id": "rpg" }