Esta API le permite gestionar cupones.
- Obtener la cadena de ofertas del usuario actual por ID
Obtener las cadenas de ofertas del usuario actual
Reclamar paso de cadena de ofertas gratuito
Crear pedido para el paso de cadena de ofertas de pago
Obtener la cadena de ofer...
Shop Builder API (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.
Descargar descripción de OpenAPI
Idiomas
Servidores
Mock server
https://xsolla.redocly.app/_mock/es/api/shop-builder/
https://store.xsolla.com/api/
Catálogo personalizado
Esta API permite especificar reglas para los atributos de usuario. Si el usuario cumple todas las condiciones de una regla específica, se mostrarán los elementos personalizados.
Para promociones personalizadas, consulte la sección Promotions.
Para transmitir atributos antes de una compra, puede utilizar Xsolla Login API o transmitirlos a la propiedad user.attributes mientras se genera el token utilizando Pay Station API.
Operaciones
Solicitud
Obtiene las cadenas de ofertas del usuario actual.
Aviso
Todos los proyectos tienen un límite de número de artículos que pueden devolverse en una sola respuesta. El valor por defecto y máximo es 30 artículos por respuesta. Para obtener más datos, utilice los parámetros de consulta
Todos los proyectos tienen un límite de número de artículos que pueden devolverse en una sola respuesta. El valor por defecto y máximo es 30 artículos por respuesta. Para obtener más datos, utilice los parámetros de consulta
limit y offset para la paginación.Seguridad
XsollaLoginUserJWT
Ruta
ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.
Ejemplo: 44056
- Mock serverhttps://xsolla.redocly.app/_mock/es/api/shop-builder/v2/project/{project_id}/user/offer_chain
- https://store.xsolla.com/api/v2/project/{project_id}/user/offer_chain
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://xsolla.redocly.app/_mock/es/api/shop-builder/v2/project/44056/user/offer_chain?limit=50&offset=0' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Respuesta
application/json
{ "has_more": false, "items": [ { … }, { … }, { … } ], "total_items_count": 3 }
Ruta
ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.
Ejemplo: 44056
- Mock serverhttps://xsolla.redocly.app/_mock/es/api/shop-builder/v2/project/{project_id}/user/offer_chain/{offer_chain_id}
- https://store.xsolla.com/api/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://xsolla.redocly.app/_mock/es/api/shop-builder/v2/project/44056/user/offer_chain/101 \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'La cadena de ofertas del usuario se ha obtenido correctamente.
Fecha en la que finaliza la cadena de ofertas. Puede ser null. Si date_end es null, la cadena de ofertas no tendrá límite de tiempo.
Ejemplo: "2020-04-15T18:16:00+05:00"
Fecha de inicio de la cadena de ofertas.
Ejemplo: "2020-04-15T18:16:00+05:00"
Número del siguiente paso de la cadena de ofertas. null si se ha completado la cadena de ofertas.
Ejemplo: 1
Periodo de reinicio de la cadena de ofertas.
Respuesta
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": [ { … }, { … } ] }
Solicitud
Completa la progresión del usuario actual por el paso de la cadena de ofertas y concede la recompensa asociada.
Aviso
Utilice esta llamada solo para los pasos gratuitos de la cadena de ofertas. Para los pasos que requieran un pago en moneda real, utilice la llamada Crear pedido para el paso de cadena de ofertas de pago.
Utilice esta llamada solo para los pasos gratuitos de la cadena de ofertas. Para los pasos que requieran un pago en moneda real, utilice la llamada Crear pedido para el paso de cadena de ofertas de pago.
Seguridad
XsollaLoginUserJWT
Ruta
ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.
Ejemplo: 44056
- Mock serverhttps://xsolla.redocly.app/_mock/es/api/shop-builder/v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim
- https://store.xsolla.com/api/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://xsolla.redocly.app/_mock/es/api/shop-builder/v2/project/44056/user/offer_chain/101/step/number/1/claim \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Respuesta
application/json
{ "order_id": 641 }