Atualiza um item de carrinho existente ou cria o item no carrinho.
- Obter carrinho por ID de carrinho
Obter o carrinho do usuário atual
Excluir todos os itens do carrinho atual
Preencher o carrinho com itens
Excluir item do carrinho atual
Atualizar item do carrinho do carrinho atual
Excluir todos os itens do carrinho pelo ID de carrinho
Preencha o carrinho específico com itens
Excluir item de carrinho por ID de carrinho
Atualizar item do carrinho por ID de carrinho
Obter carrinho por ID de...
API Shop Builder (2.0.0)
- Version: 2.0.0
- Servers:
https://store.xsolla.com/api - Contact Us by Email
- Contact URL: https://xsolla.com/
- Required TLS version: 1.2
Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc.
Transferir a descrição da OpenAPI
Idiomas
Servidores
Mock server
https://xsolla.redocly.app/_mock/pt/api/shop-builder/
https://store.xsolla.com/api/
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
Caminho
Corpoapplication/jsonID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.
Exemplo: 44056
- Mock serverhttps://xsolla.redocly.app/_mock/pt/api/shop-builder/v2/project/{project_id}/cart/item/{item_sku}
- https://store.xsolla.com/api/v2/project/{project_id}/cart/item/{item_sku}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
https://xsolla.redocly.app/_mock/pt/api/shop-builder/v2/project/44056/cart/item/booster_mega_1 \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"quantity": 123
}'Caminho
ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.
Exemplo: 44056
Consulta
A moeda do preço do item exibida no carrinho. Código de moeda de três letras de acordo com a ISO 4217. Consulte a documentação para obter informações detalhadas sobre as moedas suportadas pelo Xsolla.
Padrão "USD"
- Mock serverhttps://xsolla.redocly.app/_mock/pt/api/shop-builder/v2/project/{project_id}/cart/{cart_id}
- https://store.xsolla.com/api/v2/project/{project_id}/cart/{cart_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://xsolla.redocly.app/_mock/pt/api/shop-builder/v2/project/44056/cart/custom_id?currency=USD&locale=en' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'O carrinho com itens foi devolvido com sucesso.
Preço do carrinho.
Exemplo: {"amount":"6150.0000000000000000","amount_without_discount":"6150.0000000000000000","currency":"USD"}
Promoções aplicadas para todo o carrinho. A matriz é retornada nos seguintes casos:
Uma promoção afeta o valor total do carrinho, como um código promocional com a configuração Desconto na compra.
Uma promoção adiciona itens bônus ao carrinho.
Se nenhuma promoção no nível do pedido for aplicada, é retornada uma matriz vazia.
Resposta
application/json
{ "cart_id": "cart_id", "is_free": false, "items": [ { … } ], "price": { "amount": "6150.0000000000000000", "amount_without_discount": "6150.0000000000000000", "currency": "USD" }, "promotions": [ { … } ] }
Caminho
ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.
Exemplo: 44056
- Mock serverhttps://xsolla.redocly.app/_mock/pt/api/shop-builder/v2/project/{project_id}/cart/{cart_id}/clear
- https://store.xsolla.com/api/v2/project/{project_id}/cart/{cart_id}/clear
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
https://xsolla.redocly.app/_mock/pt/api/shop-builder/v2/project/44056/cart/custom_id/clear \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'