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

LiveOps API fornece endpoints para aumentar o engajamento dos jogadores.

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

Cupons

Esta API permite que você gerencie cupons.

Operações

Ativar promoção de cupomServer-sideAdmin

Pedido

Ativa uma promoção de cupom. A promoção de cupom criada está desabilitada por padrão. Ele não estará pronto para resgate até que você o ative. Use esse ponto de extremidade para habilitar e ativar uma promoção de cupom.

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_idintegerobrigatório

ID externo de promoção. Identificador exclusivo da promoção dentro do projeto.

Exemplo: coupon_44056_1
curl -i -X PUT \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/pt/api/liveops/v2/project/44056/admin/coupon/coupon_44056_1/activate

Respostas

O cupom foi ativado com sucesso.

Resposta
Sem conteúdo

Obter códigos de cupomServer-sideAdmin

Pedido

Obtém códigos de cupom.

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_idintegerobrigatório

ID externo de promoção. Identificador exclusivo da promoção dentro do projeto.

Exemplo: coupon_44056_1
Consulta
limitinteger>= 1

Limite da quantidade de elementos na página.

Exemplo: limit=50
offsetinteger>= 0

Número do elemento a partir do qual a lista é gerada (a quantidade começa a partir de 0).

Exemplo: offset=0
curl -i -X GET \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/pt/api/liveops/v2/project/44056/admin/coupon/coupon_44056_1/code?limit=50&offset=0'

Respostas

Lista de códigos para um cupom recebida com sucesso.

Corpoapplication/json
codesArray of objects
total_countnumber

Contagem total de códigos de cupom.

Resposta
application/json
{ "codes": [ {}, {}, {}, {}, {} ], "total_count": 5 }

Criar código de cupomServer-sideAdmin

Pedido

Cria código de cupom.

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_idintegerobrigatório

ID externo de promoção. Identificador exclusivo da promoção dentro do projeto.

Exemplo: coupon_44056_1
Corpoapplication/json
coupon_codestring(Promotions_coupon_code)[ 1 .. 128 ] characters^[a-zA-Z0-9]+$

Código exclusivo que diferencia maiúsculas de minúsculas. Contém letras e números.

Padrão "WINTER2021"
Exemplo: "WINTER2021"
curl -i -X POST \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/pt/api/liveops/v2/project/44056/admin/coupon/coupon_44056_1/code \
  -H 'Content-Type: application/json' \
  -d '{
    "coupon_code": "WINTER2021"
  }'

Respostas

Código criado com sucesso.

Corpoapplication/json
codestring(Promotions_coupon_code)[ 1 .. 128 ] characters^[a-zA-Z0-9]+$

Código exclusivo que diferencia maiúsculas de minúsculas. Contém letras e números.

Padrão "WINTER2021"
Exemplo: "WINTER2021"
Resposta
application/json
{ "code": "WINTER2021" }

Códigos promocionais

Esta API permite gerenciar códigos promocionais.

Operações

Ofertas de catálogo exclusivas

Essa API permite que você gerencie ofertas de catálogo exclusivas.

Operações

Descontos

Esta API permite-lhe gerir promoções de desconto.

Operações

Bônus

Esta API permite gerenciar promoções de bônus.

Operações

Catálogo personalizado

Essa API permite especificar regras para atributos de usuário. Se o usuário atender a todas as condições para uma regra concreta, serão exibidos itens personalizados.

Para promoções personalizadas, consulte a seção Promotions.

Para passar atributos antes de uma compra, você pode usar a Xsolla Login API ou passá-los para a propriedade user.attributes ao gerar o token usando a Pay Station API.

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