- Importar artículos mediante un archivo JSON
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.
- https://connector.xsolla.com/v1/admin/projects/{project_id}/connectors/import_items/import/status
- Mock serverhttps://xsolla.redocly.app/_mock/es/api/catalog/v1/admin/projects/{project_id}/connectors/import_items/import/status
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
https://connector.xsolla.com/v1/admin/projects/44056/connectors/import_items/import/statusEl estado de la importación se ha recuperado correctamente.
La fecha y hora de finalización de la operación de importación está en la zona horaria GMT+3. Si la importación se interrumpió debido a un error y no se importó ningún artículo, se devolverá una cadena (string) vacía.
La fecha y hora de la operación de creación de la importación expresada en la zona horaria GMT+3.
La fecha y hora en que se interrumpió la importación debido a un error, en la zona horaria GMT+3.
Un objeto con datos sobre los resultados de la importación y los errores de importación para SKU de artículos específicos.
{ "date_completed": "2024-11-19T15:27:31+03:00", "date_created": "2024-11-19T14:27:31+03:00", "date_updated": "2024-11-19T15:27:31+03:00", "error": null, "error_code": null, "progress": 100, "result": { "errors_by_sku": [ … ], "errors_count": 2, "total_entities_count": 10 }, "status": "error" }
Solicitud
Importa artículos a la tienda desde un archivo JSON mediante la URL especificada. Consulte la documentación para obtener más información sobre la importación desde un archivo JSON.
ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.
Valor fijo que especifica el tipo de operación para importar artículos.
La URL de un archivo con datos en formato JSON. El archivo debe estar alojado en un servicio de almacenamiento con acceso público. Puede descargar la plantilla del archivo en Cuenta del editor en la sección Store > Artículos virtuales > Gestionar catálogo > Importar artículos (JSON).
- https://connector.xsolla.com/v1/projects/{project_id}/import/from_external_file
- Mock serverhttps://xsolla.redocly.app/_mock/es/api/catalog/v1/projects/{project_id}/import/from_external_file
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
-u <username>:<password> \
https://connector.xsolla.com/v1/projects/44056/import/from_external_file \
-H 'Content-Type: application/json' \
-d '{
"connector_external_id": "import_items",
"file_url": "https://my-bucket.s3.amazonaws.com/items.json",
"mode": "create"
}'{ "import_id": "af9f3638a16e11ef880da2cd677d2d24" }