# Catalog API # Overview * **Version:** 2.0.0 * **Servers**: `https://store.xsolla.com/api` * **[Contact Us by Email](mailto:integration@xsolla.com)** * **Contact URL:** https://xsolla.com/ * **Required TLS version:** 1.2 Catalog API ofrece endpoints para gestionar el catálogo de su tienda en el juego y procesar compras. Use los endpoints para configurar artículos virtuales, monedas virtuales, claves del juego, lotes, flujos de carrito y pago, atributos de artículos e importar artículos desde fuentes externas. Version: 2.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForCart Al vender una cesta con juegos, puede [llamar al punto final sin autorización](/es/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users). Para ello, haga lo siguiente: * Añada un identificador único al parámetro `x-unauthorized-id` en el encabezado de los juegos. * Añada el correo electrónico del usuario al parámetro `x-user` (con codificación Base64) en el encabezado de los juegos. Por defecto, el JWT de usuario de Login de Xsolla (Bearer Token) se utiliza para la autorización. Puede intentar llamar a este punto final con un token JWT de usuario de Login de Xsolla de prueba: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Como alternativa, puede utilizar el token de acceso a [Pay Station](https://developers.xsolla.com/es/api/pay-station/operation/create-token/). Type: http Scheme: bearer ### XsollaLoginUserJWT Por defecto, el JWT de usuario de Login de Xsolla (Bearer Token) se utiliza para la autorización. Puede intentar llamar a este punto final con un token JWT de usuario de Login de Xsolla de prueba: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Como alternativa, puede utilizar el token de acceso a [Pay Station](https://developers.xsolla.com/es/api/pay-station/operation/create-token/). Type: http Scheme: bearer Bearer Format: JWT ### basicAuth La API de Xsolla utiliza autenticación básica de acceso. Todas las solicitudes a la API deben contener el encabezado `Authorization: Basic `, en el cual `your_authorization_basic_key` es el par `project_id:api_key` codificado según el estándar Base64. Puede utilizar `merchant_id` en lugar de `project_id` si lo necesita. No afecta a la funcionalidad. Vaya a [Cuenta de editor](https://publisher.xsolla.com/) para encontrar los valores de los parámetros: * Se muestra el `merchant_id`: * En la sección **Configuración de la empresa > Empresa** * En la URL de la barra de direcciones del navegador en cualquier página de cuenta de editor. La URL tiene el siguiente formato: `https://publisher.xsolla.com/`. * `api_key` se muestra en la cuenta de editor solo una vez cuando se crea y debe almacenarse en tu lado. Puedes crear una nueva clave en la siguiente sección: * **Configuración de la empresa > Claves API** * **Configuración del proyecto > Claves API** * Se muestra el `project_id`: * En Cuenta del editor junto al nombre del proyecto. * En la URL de la barra de direcciones del navegador cuando se trabaja en el proyecto en la cuenta de Publisher. La URL tiene el siguiente formato: `https://publisher.xsolla.com//projects/`. Para más información sobre cómo trabajar con claves API, consulte la [referencia API](https://developers.xsolla.com/es/api/getting-started/#api_keys_overview). Type: http Scheme: basic ### basicMerchantAuth La API de Xsolla usa una autenticación básica de acceso. Todas las solicitudes a la API deben contener el encabezado `Authorization: Basic `, en el cual `your_authorization_basic_key` es el par `merchant_id:api_key` codificado según el estándar Base64. Vaya a [Cuenta de editor](https://publisher.xsolla.com/) para encontrar los valores de los parámetros: * Se muestra el `merchant_id`: * En la sección **Configuración de la empresa > Empresa** * En la URL de la barra de direcciones del navegador en cualquier página de cuenta de editor. La URL tiene el siguiente formato: `https://publisher.xsolla.com/` * `api_key` se muestra en la cuenta de editor solo una vez cuando se crea y debe almacenarse en tu lado. Puedes crear una nueva clave en la siguiente sección: * **Configuración de la empresa > Claves API** * **Configuración del proyecto > Claves API** Para más información sobre cómo trabajar con claves API, consulte la [referencia API](https://developers.xsolla.com/es/api/getting-started/#api_keys_overview). Type: http Scheme: basic ## Download OpenAPI description [Catalog API](https://developers.xsolla.com/_bundle/@l10n/es/api/catalog/index.yaml) ## Admin ### Obtener lista de monedas virtuales - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-get-virtual-currencies-list.md): Obtiene la lista de monedas virtuales dentro de un proyecto para su administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Crear moneda virtual - [POST /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency.md): Crea una moneda virtual. ### Obtener lista de paquetes de moneda virtual (admin) - [GET /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency-packages-list.md): Obtiene la lista de paquetes de moneda virtual dentro de un proyecto para su administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Crear un paquete de moneda virtual - [POST /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency-package.md): Crea un paquete de moneda virtual. ### Eliminar el paquete de moneda virtual - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency-package.md): Elimina un paquete de moneda virtual. ### Obtener el paquete de moneda virtual - [GET /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency-package.md): Obtiene el paquete de moneda virtual dentro de un proyecto para administración. NotaNo utilice este punto final para crear un catálogo de la tienda. ### Actualizar el paquete de moneda virtual - [PUT /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency-package.md): Actualiza un paquete de moneda virtual. ### Eliminar moneda virtual - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency.md): Elimina una moneda virtual. ### Obtener moneda virtual - [GET /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency.md): Obtiene la moneda virtual dentro de un proyecto para administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Actualizar la moneda virtual - [PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency.md): Actualiza una moneda virtual. ### Obtener lista de artículos virtuales - [GET /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list.md): Obtiene la lista de artículos virtuales de un proyecto para administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Crear artículo virtual - [POST /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-create-virtual-item.md): Crea un artículo virtual. ### Obtener lista de artículos virtuales por ID externo del grupo especificado - [GET /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-external-id.md): Obtiene la lista de artículos virtuales de un grupo para su administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Obtener la lista de artículos virtuales por ID del grupo especificado - [GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-id.md): Obtiene la lista de artículos virtuales de un grupo para su administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Borrar artículo virtual - [DELETE /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-delete-virtual-item.md): Elimina un artículo virtual. ### Obtener artículo virtual - [GET /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-get-virtual-item.md): Obtiene el artículo virtual dentro de un proyecto para su administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Actualizar artículo virtual - [PUT /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-admin/admin-update-virtual-item.md): Actualiza un artículo virtual. ## Catálogo ### Obtener lista de grupos de artículos - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-item-groups.md): Obtiene una lista de grupos de artículos para crear un catálogo. ### Obtener lista de monedas virtuales - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-virtual-currency.md): Obtiene una lista de monedas virtuales para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener la lista de paquetes de moneda virtual - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package.md): Obtiene una lista de paquetes de moneda virtual para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener paquete de moneda virtual por SKU - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package-sku.md): Obtiene paquetes de moneda virtual por SKU para crear un catálogo. Nota Este punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para un resultado personalizado, como los límites de usuario y las promociones disponibles. ### Obtener moneda virtual por SKU - [GET /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-virtual-currency-sku.md): Obtiene una moneda virtual por SKU para crear un catálogo. Nota Este punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para un resultado personalizado, como los límites de usuario y las promociones disponibles. ### Obtener lista de artículos virtuales - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-virtual-items.md): Obtiene una lista de artículos virtuales para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener la lista de todos los artículos virtuales - [GET /v2/project/{project_id}/items/virtual_items/all](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-all-virtual-items.md): Obtiene una lista de todos los artículos virtuales para su búsqueda en el lado del cliente. AtenciónSolo devuelve el SKU, el nombre, los grupos y la descripción del artículo NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener lista de artículos por grupo especificado - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-virtual-items-group.md): Obtiene una lista de artículos del grupo especificado para crear un catálogo. AtenciónTodos los proyectos tienen la limitación del número de artículos que se pueden obtener en la respuesta. El valor máximo y por defecto es 50 artículos por respuesta. Para obtener más datos página por página, utilice los campos limit y offset. Nota Este punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con datos específicos del usuario para obtener un resultado personalizado, como los límites de usuario y las promociones disponibles. ### Obtener artículo virtual por SKU - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-virtual-items-sku.md): Obtiene un artículo virtual por SKU para crear un catálogo. Nota Este punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para un resultado personalizado, como los límites de usuario y las promociones disponibles. ## Pago virtual ### Crear pedido con artículo especificado comprado mediante moneda virtual - [POST /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}](https://developers.xsolla.com/es/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency.md): Crea una compra de artículos utilizando moneda virtual. ## Catálogo ### Obtener lista de juegos - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/es/api/catalog/game-keys-catalog/get-games-list.md): Obtiene una lista de juegos para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener lista de sistemas de DRM - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/es/api/catalog/game-keys-catalog/get-drm-list.md): Obtiene la lista de sistemas de DRM (gestión de derechos digitales) disponibles. ### Obtener lista de juegos por grupo especificado - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/es/api/catalog/game-keys-catalog/get-games-group.md): Obtiene una lista de juegos del grupo especificado para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener la lista de claves de juego por grupo especificado - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/es/api/catalog/game-keys-catalog/get-game-keys-group.md): Obtiene una lista de claves de juego del grupo especificado para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener clave del juego para el catálogo - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/game-keys-catalog/get-game-key-by-sku.md): Obtiene una clave de juego para el catálogo. NotaEste punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para obtener un resultado personalizado, como los límites de usuario y las promociones disponibles. ### Obtener juego para el catálogo - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/game-keys-catalog/get-game-by-sku.md): Obtiene un juego para el catálogo. NotaEste punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para obtener un resultado personalizado, como los límites de usuario y las promociones disponibles. ## Derechos ### Conceder derecho (admin) - [POST /v2/project/{project_id}/admin/entitlement/grant](https://developers.xsolla.com/es/api/catalog/game-keys-entitlement/grant-entitlement-admin.md): Concede el derecho al usuario. AtenciónSolo se pueden conceder códigos de juego o juegos para plataformas sin DRM (gestión de derechos digitales). ### Revocar el derecho (admin) - [POST /v2/project/{project_id}/admin/entitlement/revoke](https://developers.xsolla.com/es/api/catalog/game-keys-entitlement/revoke-entitlement-admin.md): Revoca el derecho del usuario. AtenciónSolo se pueden conceder códigos de juego o juegos para plataformas sin DRM (gestión de derechos digitales). ### Obtener la lista de juegos propiedad del usuario - [GET /v2/project/{project_id}/entitlement](https://developers.xsolla.com/es/api/catalog/game-keys-entitlement/get-user-games.md): Obtiene la lista de juegos propiedad del usuario. La respuesta contendrá una matriz de juegos propiedad de un usuario concreto. AtenciónTodos los proyectos tienen la limitación del número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es 50 artículos por respuesta. Para obtener más datos página por página, utilice los campos limit y offset. ### Canjear código del juego por cliente - [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/es/api/catalog/game-keys-entitlement/redeem-game-pin-code.md): Concede el derecho mediante un código de juego suministrado. AtenciónSólo puede canjear códigos para la plataforma sin DRM (gestión de derechos digitales). ## Admin ### Obtener lista de juegos (admin) - [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-get-game-list.md): Obtiene la lista de juegos dentro de un proyecto para su administración. El juego se compone de claves del juego que podrían ser compradas por un usuario. NotaNo utilice este punto final para crear un catálogo de tienda. ### Crear juego - [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-create-game.md): Crea un juego en el proyecto. ### Eliminar un juego por su ID - [DELETE /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-delete-game-by-id.md): Elimina un juego del proyecto por su ID. ### Obtener juego por ID (admin) - [GET /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-get-game-by-id.md): Obtiene un juego para administración. El juego se compone de claves del juego que podrían ser compradas por un usuario. NotaNo utilice este punto final para crear un catálogo de tienda. ### Actualizar juego por su ID - [PUT /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-update-game-by-id.md): Actualiza un juego en el proyecto por su ID. ### Borrar códigos por ID - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-delete-codes-by-id.md): Elimina todos los códigos por ID de la clave del juego. ### Eliminar códigos - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-delete-codes-by-sku.md): Elimina todos los códigos por SKU de clave de juego. ### Obtener códigos por ID - [GET /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-get-codes-by-id.md): Obtiene un determinado número de códigos por la ID de la clave del juego. ### Obtener códigos - [GET /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-get-codes-by-sku.md): Obtiene un determinado número de códigos por SKU de clave de juego. ### Cargar códigos por ID - [POST /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-upload-codes-by-id.md): Carga códigos por la ID de la clave del juego. ### Obtener información de la sesión de carga de códigos - [GET /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-get-codes-session.md): Obtiene información de la sesión de carga de códigos. ### Cargar códigos - [POST /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-upload-codes-by-sku.md): Carga códigos por SKU de clave de juego. ### Eliminar juego por SKU - [DELETE /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-delete-game-by-sku.md): Elimina un juego del proyecto por SKU. ### Obtener juego (admin) - [GET /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-get-game-by-sku.md): Obtiene un juego para administración. El juego se compone de claves del juego que podrían ser compradas por un usuario. NotaNo utilice este punto final para crear un catálogo de tienda. ### Actualizar juego por SKU - [PUT /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/game-keys-admin/admin-update-game-by-sku.md): Actualiza un juego en el proyecto por SKU. ## Admin ### Obtener lista de lotes - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/es/api/catalog/bundles-admin/admin-get-bundle-list.md): Obtiene la lista de lotes de un proyecto para administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Crear lote - [POST /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/es/api/catalog/bundles-admin/admin-create-bundle.md): Crea un lote. ### Obtener lista de lotes por ID externo del grupo especificado - [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://developers.xsolla.com/es/api/catalog/bundles-admin/admin-get-bundle-list-in-group-by-external-id.md): Obtiene la lista de lotes dentro de un grupo para administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Obtener lista de lotes por ID de grupo especificado - [GET /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}](https://developers.xsolla.com/es/api/catalog/bundles-admin/admin-get-bundle-list-in-group-by-id.md): Obtiene la lista de lotes dentro de un grupo para administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Eliminar lote - [DELETE /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/es/api/catalog/bundles-admin/admin-delete-bundle.md): Elimina un lote. ### Obtener lote - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/es/api/catalog/bundles-admin/admin-get-bundle.md): Obtiene el lote dentro de un proyecto para administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Actualizar lote - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/es/api/catalog/bundles-admin/admin-update-bundle.md): Actualiza un lote. ### Ocultar lote en el catálogo - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://developers.xsolla.com/es/api/catalog/bundles-admin/admin-hide-bundle.md): Oculta un lote en un catálogo. ### Mostrar lote en el catálogo - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://developers.xsolla.com/es/api/catalog/bundles-admin/admin-show-bundle.md): Muestra un lote en un catálogo. ## Catálogo ### Obtener lista de lotes - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/es/api/catalog/bundles-catalog/get-bundle-list.md): Obtiene una lista de lotes para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener la lista de lotes por grupo especificado - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://developers.xsolla.com/es/api/catalog/bundles-catalog/get-bundle-list-in-group.md): Obtiene una lista de lotes dentro de un grupo para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener el lote especificado - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/es/api/catalog/bundles-catalog/get-bundle.md): Obtiene un paquete especificado. NotaEste punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para un resultado personalizado, como los límites de usuario y las promociones disponibles. ## Cesta (cliente) ### Obtener la cesta del usuario actual - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/es/api/catalog/cart-client-side/get-user-cart.md): Devuelve la cesta del usuario actual. ### Eliminar todos los artículos de la cesta actual - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/es/api/catalog/cart-client-side/cart-clear.md): Elimina todos los artículos de la cesta. ### Llenar la cesta con artículos - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/es/api/catalog/cart-client-side/cart-fill.md): Llena la cesta con artículos. Si la cesta ya tiene un artículo con el mismo SKU, el artículo existente se sustituirá por el valor transmitido. ### Eliminar artículo de la cesta actual - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/es/api/catalog/cart-client-side/delete-item.md): Elimina un artículo de la cesta. ### Actualizar artículo de la cesta actual - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/es/api/catalog/cart-client-side/put-item.md): Actualiza un artículo de la cesta existente o crea el de la cesta. ### Obtener cesta por el ID de la cesta - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/es/api/catalog/cart-client-side/get-cart-by-id.md): Devuelve la cesta del usuario por el ID de la cesta. ### Eliminar todos los artículos de la cesta por el ID de la cesta - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/es/api/catalog/cart-client-side/cart-clear-by-id.md): Elimina todos los artículos de la cesta. ### Llenar la cesta específica con artículos - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/es/api/catalog/cart-client-side/cart-fill-by-id.md): Llena la cesta específica con artículos. Si la cesta ya contiene un artículo con el mismo SKU, la posición del artículo existente se sustituirá por el valor transmitido. ### Eliminar artículo de la cesta por ID de la cesta - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/es/api/catalog/cart-client-side/delete-item-by-cart-id.md): Elimina un artículo de la cesta. ### Actualizar artículo de la cesta por ID de la cesta - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/es/api/catalog/cart-client-side/put-item-by-cart-id.md): Actualiza un artículo de la cesta existente o crea el de la cesta. ## Cesta (lado del servidor) ### Llenar la cesta con artículos - [PUT /v2/admin/project/{project_id}/cart/fill](https://developers.xsolla.com/es/api/catalog/cart-server-side/admin-cart-fill.md): Rellena la cesta actual con artículos. Si la cesta ya tiene un artículo con el mismo SKU, el artículo existente se sustituirá por el valor transmitido. ### Llenar la cesta con artículos por el ID de la cesta - [PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/es/api/catalog/cart-server-side/admin-fill-cart-by-id.md): Rellena la cesta con artículos por ID de la cesta. Si la cesta ya tiene un artículo con el mismo SKU, el artículo existente se sustituirá por el valor transmitido. ## Pago (lado del cliente) ### Crear pedido con todos los artículos de la cesta actual - [POST /v2/project/{project_id}/payment/cart](https://developers.xsolla.com/es/api/catalog/payment-client-side/create-order.md): Se utiliza para la integración cliente-servidor. Crea un pedido con todos los artículos de la cesta y genera un token de pago para esta. El pedido creado obtiene el estado de pedido new. La IP del cliente se utiliza para determinar el país del usuario, que a su vez se utiliza para aplicar la moneda correspondiente y los métodos de pago disponibles para el pedido. Para abrir la interfaz de pago en una nueva ventana, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token={token}, en el cual {token} es el token recibido. Para realizar pruebas, utilice esta URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Como este método utiliza la IP para determinar el país del usuario y seleccionar una moneda para el pedido, es importante utilizar este método solamente desde el lado del cliente y no desde el lado del servidor. El uso de este método desde el lado del servidor puede causar una determinación incorrecta de la moneda y afectar a los métodos de pago en Pay Station. ### Crear pedido con todos los artículos de la cesta - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://developers.xsolla.com/es/api/catalog/payment-client-side/create-order-by-cart-id.md): Se utiliza para la integración cliente-servidor. Crea un pedido con todos los artículos de la cesta concreta y genera un token de pago para esta. El pedido creado obtiene el estado de pedido new. La IP del cliente se utiliza para determinar el país del usuario, que a su vez se utiliza para aplicar la moneda correspondiente y los métodos de pago disponibles para el pedido. Para abrir la interfaz de pago en una nueva ventana, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token={token}, en el cual {token} es el token recibido. Para realizar pruebas, utilice esta URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Como este método utiliza la IP para determinar el país del usuario y seleccionar una moneda para el pedido, es importante utilizar este método solamente desde el lado del cliente y no desde el lado del servidor. El uso de este método desde el lado del servidor puede causar una determinación incorrecta de la moneda y afectar a los métodos de pago en Pay Station. ### Crear pedido con un artículo especificado - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://developers.xsolla.com/es/api/catalog/payment-client-side/create-order-with-item.md): Se utiliza para la integración cliente-servidor. Crea un pedido con un artículo específico y genera un token de pago para este. El pedido creado obtiene el newestado de pedido. La IP del cliente se utiliza para determinar el país del usuario, que a su vez se utiliza para aplicar la moneda correspondiente y los métodos de pago disponibles para el pedido. Para abrir la interfaz de pago en una nueva ventana, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token={token}, en el cual {token} es el token recibido. Para realizar pruebas, utilice esta URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Como este método utiliza la IP para determinar el país del usuario y seleccionar una moneda para el pedido, es importante utilizar este método solamente desde el lado del cliente y no desde el lado del servidor. El uso de este método desde el lado del servidor puede causar una determinación incorrecta de la moneda y afectar a los métodos de pago en Pay Station. ## Pago (lado del servidor) ### Crear token de pago para la compra - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/es/api/catalog/payment-server-side/admin-create-payment-token.md): Genera un pedido y un token de pago para el mismo. El pedido se genera en función de los artículos transmitidos en el cuerpo de la solicitud. Para abrir la interfaz de usuario para pagos en una nueva ventana, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token={token}, en el cual {token} es el token recibido. Para realizar pruebas, utilice esta URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso El parámetro user.country.value se usa para seleccionar una moneda para el pedido. Si se desconoce el país del usuario, otra opción es proporcionar la IP del usuario en el encabezado X-User-Ip. Se requiere una de estas dos opciones para el correcto funcionamiento de este método. La moneda seleccionada se usa para los métodos de pago en Pay Station. ## Pedido ### Obtener pedido - [GET /v2/project/{project_id}/order/{order_id}](https://developers.xsolla.com/es/api/catalog/order/get-order.md): Recupera un pedido especificado. ### Obtener la lista de pedidos del periodo especificado - [POST /v3/project/{project_id}/admin/order/search](https://developers.xsolla.com/es/api/catalog/order/admin-order-search.md): Recupera la lista de pedidos, ordenados de la fecha de creación más antigua a la más reciente. ## Artículos gratuitos ### Crear pedido con cesta gratuita - [POST /v2/project/{project_id}/free/cart](https://developers.xsolla.com/es/api/catalog/free-item/create-free-order.md): Crea un pedido con todos los artículos de la cesta gratuita. El pedido creado obtendrá el estado de pedido done. ### Crear pedido con una cesta gratuita concreta - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://developers.xsolla.com/es/api/catalog/free-item/create-free-order-by-cart-id.md): Crea un pedido con todos los artículos de la cesta gratuita concreta. El pedido creado obtendrá el estado de pedido done. ### Crear pedido con un artículo gratuito especificado - [POST /v2/project/{project_id}/free/item/{item_sku}](https://developers.xsolla.com/es/api/catalog/free-item/create-free-order-with-item.md): Crea un pedido con un artículo gratuito especificado. El pedido creado obtendrá el estado de pedido done. ## Gestión ### Actualizar todos los límites de compra para un usuario especificado - [DELETE /v2/project/{project_id}/admin/user/limit/item/all](https://developers.xsolla.com/es/api/catalog/user-limits-admin/reset-all-user-items-limit.md): Actualiza todos los límites de compra de todos los artículos para un usuario especificado para que pueda comprar estos artículos de nuevo. La API de límite del usuario le permite vender un artículo en una cantidad limitada. Para configurar los límites de compra, vaya a Admin del módulo del tipo de artículo deseado: * Game Keys * Virtual Items & Currency * Bundles ### Reducir el número de artículos disponibles para un usuario especificado - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/user-limits-admin/remove-user-item-limit.md): Reduce el número restante de artículos disponibles para el usuario especificado dentro del límite aplicado. La API de límite del usuario le permite vender un artículo en una cantidad limitada. Para configurar los límites de compra, vaya a Admin del módulo del tipo de artículo deseado: * Game Keys * Virtual Items & Currency * Bundles ### Obtener el número de artículos disponibles para un usuario especificado - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/user-limits-admin/get-user-item-limit.md): Obtiene el número restante de artículos disponibles para el usuario especificado dentro del límite aplicado. La API de límite del usuario le permite vender un artículo en una cantidad limitada. Para configurar los límites de compra, vaya a Admin del módulo del tipo de artículo deseado: * Game Keys * Virtual Items & Currency * Bundles ### Aumentar el número de artículos disponibles para el usuario especificado - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/user-limits-admin/add-user-item-limit.md): Aumenta el número restante de artículos disponibles para el usuario especificado dentro del límite aplicado. La API de límite del usuario le permite vender un artículo en una cantidad limitada. Para configurar los límites de compra, vaya a Admin del módulo del tipo de artículo deseado: * Game Keys * Virtual Items & Currency * Bundles ### Establecer el número de artículos disponibles para el usuario especificado - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/user-limits-admin/set-user-item-limit.md): Establece el número de artículos que el usuario especificado puede comprar dentro del límite aplicado después de que se haya aumentado o reducido. La API de límite del usuario le permite vender un artículo en una cantidad limitada. Para configurar los límites de compra, vaya a Admin del módulo del tipo de artículo deseado: * Game Keys * Virtual Items & Currency * Bundles ### Actualizar límite de compra - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/es/api/catalog/user-limits-admin/reset-user-item-limit.md): Actualiza el límite de compra de un artículo para que un usuario pueda volver a comprarlo. Si el parámetro user es null, esta llamada actualiza este límite para todos los usuarios. La API de límite del usuario permite vender un artículo en una cantidad limitada. Para configurar los límites de compra, vaya a Admin del módulo del tipo de artículo deseado: * Game Keys * Virtual Items & Currency * Bundles ## Admin ### Obtener el estado de la importación de artículos - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/es/api/catalog/connector-admin/get-items-import-status.md): Recupera información sobre el progreso de la importación de artículos al proyecto. Esta llamada API recupera datos sobre la última importación realizada mediante la API o mediante Cuenta del editor. ### Importar artículos mediante un archivo JSON - [POST /v1/projects/{project_id}/import/from_external_file](https://developers.xsolla.com/es/api/catalog/connector-admin/import-items-from-external-file.md): 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. ## Webhooks ### Obtener información sobre la configuración de webhooks - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/es/api/catalog/common-webhooks/get-webhook.md): Obtiene la información sobre la configuración de webhooks en Store. Consulte la documentación de webhooks para obtener más información. ### Actualizar la información sobre la configuración de webhooks - [PUT /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/es/api/catalog/common-webhooks/update-webhook.md): Actualiza la información sobre la configuración de webhooks en Store. Consulte la documentación de webhooks para obtener más información. ## Pedidos anticipados ### Eliminar el límite de cantidad de artículos para pedidos por anticipado - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/common-pre-orders/remove-pre-order-limit.md): Elimina la cantidad del límite de pedido por anticipado del artículo. La API de límite de pedido por anticipado le permite vender un artículo en una cantidad limitada. Para configurar el pedido por anticipado, vaya a Admin del módulo del artículo deseado: * Game Keys * Virtual Items & Currency * Bundles Alias para este punto final: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Obtener información sobre el límite de pedidos por anticipado del artículo - [GET /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/common-pre-orders/get-pre-order-limit.md): Obtenga el límite de pedido por anticipado del artículo. La API de límite de pedido por anticipado le permite vender un artículo en una cantidad limitada. Para configurar el pedido por anticipado, vaya a Admin del módulo del artículo deseado: * Game Keys * Virtual Items & Currency * Bundles Alias para este punto final: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Agregar cantidad al límite de pedidos por anticipado del artículo - [POST /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/common-pre-orders/add-pre-order-limit.md): Añada la cantidad del límite de pedido por anticipado del artículo. La API de límite de pedido por anticipado le permite vender un artículo en una cantidad limitada. Para configurar el pedido por anticipado, vaya a Admin del módulo del artículo deseado: * Game Keys * Virtual Items & Currency * Bundles Alias para este punto final: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Establecer el límite de cantidad de artículos para pedidos por anticipado - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/catalog/common-pre-orders/set-pre-order-limit.md): Establezca la cantidad del límite de pedido por anticipado del artículo. La API de límite de pedido por anticipado le permite vender un artículo en una cantidad limitada. Para configurar el pedido por anticipado, vaya a Admin del módulo del artículo deseado: * Game Keys * Virtual Items & Currency * Bundles Alias para este punto final: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Eliminar todo el límite de cantidad de artículos para pedidos por anticipado - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/es/api/catalog/common-pre-orders/remove-all-pre-order-limit.md): Elimine toda la cantidad de límite de pedido por anticipado del artículo. La API de límite de pedido por anticipado le permite vender un artículo en una cantidad limitada. Para configurar el pedido por anticipado, vaya a Admin del módulo del artículo deseado: * Game Keys * Virtual Items & Currency * Bundles Alias para este punto final: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/all ### Cambiar el límite para los pedidos por anticipado del artículo - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://developers.xsolla.com/es/api/catalog/common-pre-orders/toggle-pre-order-limit.md): Habilitar/deshabilitar el límite para los pedidos por anticipado del artículo. La API de límite de pedido por anticipado le permite vender un artículo en una cantidad limitada. Para configurar el pedido por anticipado, vaya a Admin del módulo del artículo deseado: * Game Keys * Virtual Items & Currency * Bundles Alias para este punto final: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/toggle ## Comerciante ### Obtener proyectos - [GET /v2/merchant/{merchant_id}/projects](https://developers.xsolla.com/es/api/catalog/common-merchant/get-projects.md): Obtiene la lista de proyectos del comerciante. AvisoEsta llamada API no contiene el parámetro de ruta project_id, para que no tenga que utilizar la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización. ## Catálogo Esta API permite obtener cualquier tipo de artículo vendible o artículo específico. ### Obtener lista de artículos vendibles - [GET /v2/project/{project_id}/items](https://developers.xsolla.com/es/api/catalog/common-catalog/get-sellable-items.md): Obtiene una lista de artículos vendibles para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener lista de artículos vendibles por grupo especificado - [GET /v2/project/{project_id}/items/group/{external_id}](https://developers.xsolla.com/es/api/catalog/common-catalog/get-sellable-items-group.md): Obtiene una lista de artículos vendibles del grupo especificado para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener artículo vendible por ID - [GET /v2/project/{project_id}/items/id/{item_id}](https://developers.xsolla.com/es/api/catalog/common-catalog/get-sellable-item-by-id.md): Obtiene un artículo vendible por su ID. NotaEste punto final, accesible sin autorización, devuelve datos genéricos. No obstante, la autorización enriquece la respuesta con detalles específicos del usuario para obtener un resultado personalizado, como los límites de usuario y las promociones disponibles. ### Obtener artículo vendible por SKU - [GET /v2/project/{project_id}/items/sku/{sku}](https://developers.xsolla.com/es/api/catalog/common-catalog/get-sellable-item-by-sku.md): Obtiene un artículo vendible por SKU para crear un catálogo. NotaEste punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para obtener un resultado personalizado, como los límites de usuario y las promociones disponibles. ## Regiones comunes ### Obtener lista de regiones - [GET /v2/project/{project_id}/admin/region](https://developers.xsolla.com/es/api/catalog/common-regions/admin-get-regions.md): Obtiene la lista de regiones. Puede utilizar una región para gestionar sus restricciones regionales. ### Crear región - [POST /v2/project/{project_id}/admin/region](https://developers.xsolla.com/es/api/catalog/common-regions/admin-create-region.md): Crea una región. Puede utilizar una región para gestionar sus restricciones regionales. ### Eliminar región - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/es/api/catalog/common-regions/admin-delete-region.md): Elimina una región concreta. ### Obtener región - [GET /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/es/api/catalog/common-regions/admin-get-region.md): Obtiene una región concreta. Puede utilizar una región para gestionar sus restricciones regionales. ### Actualizar región - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/es/api/catalog/common-regions/admin-update-region.md): Actualiza una región concreta. Puede utilizar una región para gestionar sus restricciones regionales. ## Admin ### Obtener lista de atributos (admin) - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/es/api/catalog/attribute-admin/admin-get-attribute-list.md): Obtiene la lista de atributos de un proyecto para su administración. ### Crear atributo - [POST /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/es/api/catalog/attribute-admin/admin-create-attribute.md): Crea un atributo. ### Eliminar atributo - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/es/api/catalog/attribute-admin/delete-attribute.md): Elimina un atributo. AvisoSi elimina un atributo de artículo, se perderán todos sus datos y conexiones con los artículos. ### Obtener atributo especificado - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/es/api/catalog/attribute-admin/admin-get-attribute.md): Obtiene un atributo especificado. ### Actualizar atributo - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/es/api/catalog/attribute-admin/admin-update-attribute.md): Actualiza un atributo. ### Borrar todos los valores del atributo - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/es/api/catalog/attribute-admin/admin-delete-all-attribute-value.md): Elimina todos los valores del atributo. AvisoSi elimina el valor de un atributo, se perderán todas las conexiones entre el atributo y los artículos. Para cambiar el valor de atributo de un artículo, utilice la llamada API Actualizar valor de atributo en vez de eliminar el valor y crear uno nuevo. ### Crear valor de atributo - [POST /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/es/api/catalog/attribute-admin/admin-create-attribute-value.md): Crea un valor de atributo. AtenciónTodos los proyectos tienen limitación del número de valores de atributo. El valor por defecto y máximo es 20 valores por atributo. ### Eliminar valor de atributo - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/es/api/catalog/attribute-admin/admin-delete-attribute-value.md): Elimina un valor de atributo. AvisoSi elimina el valor de un atributo, se perderán todas las conexiones entre el atributo y los artículos. Para cambiar el valor de atributo de un artículo, utilice la llamada API Actualizar valor de atributo en vez de eliminar el valor y crear uno nuevo. ### Actualizar valor de atributo - [PUT /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/es/api/catalog/attribute-admin/admin-update-attribute-value.md): Actualiza los valores de un atributo.