Devuelve la cesta del usuario actual.
- Eliminar todos los artículos de la cesta actual
API de catálogo (2.0.0)
- Versión: 2.0.0
- Servidores:
https://store.xsolla.com/api - Contacte con nosotros por correo electrónico
- URL de contacto: https://xsolla.com/
- Versión de TLS requerida: 1.2
La API de catálogo le permite configurar un catálogo de artículos de juego en el lado de Xsolla y mostrar dicho catálogo a los usuarios de su tienda.
La API le permite gestionar las siguientes entidades de catálogo:
- Artículos virtuales: artículos de juego, como armas, apariencias o potenciadores.
- Moneda virtual: dinero virtual que se utiliza para comprar productos virtuales.
- Paquetes de moneda virtual: lotes predefinidos de moneda virtual.
- Lotes: paquetes combinados de artículos virtuales, moneda o claves de juego que se venden como un único SKU.
- Claves de juego: claves para juegos y DLC distribuidos a través de plataformas como Steam u otros proveedores de DRM.
- Grupos: agrupaciones lógicas para organizar y clasificar artículos dentro del catálogo.
La API se divide en los siguientes grupos:
Admin : llamadas para crear, actualizar, eliminar y configurar artículos de catálogo y grupos. La autenticación se realiza mediante autenticación de acceso básica con sus credenciales de comerciante o de proyecto. No está diseñado para uso en escaparates.Catalog : llamadas para buscar artículos y crear escaparates personalizados para los usuarios finales. Diseñado para gestionar situaciones de alta carga. Admite la autorización JWT opcional de usuarios para devolver datos personalizados, como límites específicos para determinados usuarios y promociones activas.
ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.
Moneda en la que se muestra el precio del artículo en la cesta. Código de moneda de tres letras según ISO 4217. Consulte la documentación para obtener información detallada sobre monedas soportadas por Xsolla.
- https://store.xsolla.com/api/v2/project/{project_id}/cart
- Mock serverhttps://xsolla.redocly.app/_mock/es/api/catalog/v2/project/{project_id}/cart
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://store.xsolla.com/api/v2/project/44056/cart?currency=USD&locale=en' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'La cesta con artículos se devolvió correctamente.
Si true, la cesta es gratuita.
Precio de la cesta.
Promociones aplicadas a toda la cesta. La matriz se devuelve en los siguientes casos:
Una promoción afecta al importe total de la cesta, como un código promocional con el parámetro Descuento en la compra.
Una promoción añade artículos de bonificación a la cesta.
Si no se aplican promociones a nivel de pedido, se devuelve una matriz vacía.
{ "cart_id": "cart_id", "is_free": false, "items": [ { … } ], "price": { "amount": "6150.0000000000000000", "amount_without_discount": "6150.0000000000000000", "currency": "USD" }, "promotions": [ { … } ] }
ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.
- https://store.xsolla.com/api/v2/project/{project_id}/cart/clear
- Mock serverhttps://xsolla.redocly.app/_mock/es/api/catalog/v2/project/{project_id}/cart/clear
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
https://store.xsolla.com/api/v2/project/44056/cart/clear \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.
- https://store.xsolla.com/api/v2/project/{project_id}/cart/fill
- Mock serverhttps://xsolla.redocly.app/_mock/es/api/catalog/v2/project/{project_id}/cart/fill
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
https://store.xsolla.com/api/v2/project/44056/cart/fill \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"items": [
{
"quantity": 123,
"sku": "com.xsolla.booster_mega_1"
}
]
}'La cesta con artículos se devolvió correctamente.
Si true, la cesta es gratuita.
Precio de la cesta.
Promociones aplicadas a toda la cesta. La matriz se devuelve en los siguientes casos:
Una promoción afecta al importe total de la cesta, como un código promocional con el parámetro Descuento en la compra.
Una promoción añade artículos de bonificación a la cesta.
Si no se aplican promociones a nivel de pedido, se devuelve una matriz vacía.
{ "cart_id": "cart_id", "is_free": false, "items": [ { … } ], "price": { "amount": "6150.0000000000000000", "amount_without_discount": "6150.0000000000000000", "currency": "USD" }, "promotions": [ { … } ], "warnings": [ { … } ] }