ID de cadeia de ofertas.
- Obtenha as cadeias de ofertas do usuário atual
Obter a cadeia de ofertas do usuário atual por ID
Resgate a etapa da cadeia de oferta gratuita
Criar ordem para a etapa da cadeia de ofertas pagas
Obtenha as cadeias de ofe...
LiveOps API (2.0.0)
- Versão: 2.0.0
- Servidores:
https://store.xsolla.com/api - Contate-nos por e-mail
- URL de contato: https://xsolla.com/
- Versão TLS necessária: 1.2
LiveOps é um kit de ferramentas para gerar engajamento contínuo com os jogadores através de promoções e ofertas personalizadas.
Use a API para gerenciar os seguintes recursos:
- Promoções — crie e gerencie cupons, códigos promocionais, descontos e campanhas bônus.
- Personalização — especifique as condições para exibir o catálogo de itens e aplicar as promoções somente para certos usuários autorizados.
- Limites de promoção — defina um limite sobre quantas vezes uma promoção pode ser usada por um usuário e configure as redefinições programadas para esses limites.
- Cadeias de recompensas e pontos de valor — configure a progressão de recompensas vinculada ao acúmulo de pontos de valor.
- Cadeias diárias — configure recompensas diárias recorrentes para motivar acessos regulares.
- Cadeias de ofertas — construa ofertas de compra sequenciais com precificações por etapa e opções de recompensas gratuitas.
- Venda cruzada — um método de venda na qual o usuário recebe a oferta de comprar um item com valor adicional.
A API se divide nos seguintes grupos:
Admin — chamadas para criar, atualizar, ativar e excluir campanhas e configurações de cadeias. Autenticada via autenticação de acesso básica com seu comerciante ou as credenciais do projeto.Client — chamadas para recuperar as promoções disponíveis, obter cadeias ativas, resgatar códigos e resgatar recompensas em nome de usuários finais autenticados. Autenticado via JWT de usuário.
Transferir a descrição da OpenAPI
Idiomas
Servidores
https://store.xsolla.com/api/
Mock server
https://xsolla.redocly.app/_mock/pt/api/liveops/
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
Pedido
Obtém as cadeias de ofertas atuais do usuário.
Aviso
Todos os projetos têm um limite no número de itens que podem ser retornados em uma única resposta. O valor padrão e máximo é de 30 itens por resposta. Para obter mais dados, use os parâmetros de consulta
Todos os projetos têm um limite no número de itens que podem ser retornados em uma única resposta. O valor padrão e máximo é de 30 itens por resposta. Para obter mais dados, use os parâmetros de consulta
limit e offset para a paginação.Segurança
XsollaLoginUserJWT
Caminho
ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.
Exemplo: 44056
- https://store.xsolla.com/api/v2/project/{project_id}/user/offer_chain
- Mock serverhttps://xsolla.redocly.app/_mock/pt/api/liveops/v2/project/{project_id}/user/offer_chain
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://store.xsolla.com/api/v2/project/44056/user/offer_chain?limit=50&offset=0' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Resposta
application/json
{ "has_more": false, "items": [ { … }, { … }, { … } ], "total_items_count": 3 }
Caminho
ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.
Exemplo: 44056
- https://store.xsolla.com/api/v2/project/{project_id}/user/offer_chain/{offer_chain_id}
- Mock serverhttps://xsolla.redocly.app/_mock/pt/api/liveops/v2/project/{project_id}/user/offer_chain/{offer_chain_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://store.xsolla.com/api/v2/project/44056/user/offer_chain/101 \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'A cadeia de ofertas do usuário foi recuperada com sucesso.
Data em que a cadeia de ofertas termina. Pode ser null. Se date_end for null, a cadeia de ofertas não terá um limite de tempo.
Exemplo: "2020-04-15T18:16:00+05:00"
Data em que a cadeia de ofertas é iniciada.
Exemplo: "2020-04-15T18:16:00+05:00"
Número da próxima etapa da cadeia de ofertas. null se a cadeia de ofertas foi concluída.
Exemplo: 1
Período de redefinição da cadeia de ofertas.
Resposta
application/json
{ "date_end": "2025-04-25T18:16:00+05:00", "date_start": "2010-04-15T18:16:00+05:00", "description": null, "id": 4, "name": "Offer chain with bundles", "next_step_number": 1, "order": 1, "recurrent_schedule": null, "steps": [ { … }, { … } ] }
Pedido
Conclui a progressão do usuário atual por meio da etapa da cadeia de ofertas e concede a recompensa associada.
Aviso
Use essa chamada somente para etapas gratuitas na cadeia de ofertas. Para etapas que exigem pagamento em moeda real, use a chamada Criar ordem para a etapa da cadeia de ofertas pagas.
Use essa chamada somente para etapas gratuitas na cadeia de ofertas. Para etapas que exigem pagamento em moeda real, use a chamada Criar ordem para a etapa da cadeia de ofertas pagas.
Segurança
XsollaLoginUserJWT
Caminho
ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.
Exemplo: 44056
- https://store.xsolla.com/api/v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim
- Mock serverhttps://xsolla.redocly.app/_mock/pt/api/liveops/v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://store.xsolla.com/api/v2/project/44056/user/offer_chain/101/step/number/1/claim \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Resposta
application/json
{ "order_id": 641 }