# Digital Distribution Hub # Información general Digital Distribution Hub es una nueva solución de Xsolla que tiene por objetivo conectar los pagos digitales y en efectivo a través de la tecnología de pagos únicos inmediatos ('push') y de comercio electrónico. Esta referencia combina puntos finales de API para dos productos de Xsolla: [In-Game Store](https://developers.xsolla.com/es/doc/in-game-store/) y [Pay Station](https://developers.xsolla.com/es/doc/pay-station/). Hay dos URL base: * `https://store.xsolla.com/api` para los grupos **Common**, **Catalog**, **Cart**, y **Order**. * `https://ps.xsolla.com` para el grupo **Notifications**. Los puntos finales de API en el grupo **Catalog** no requieren autorización. Para realizar operaciones en los grupos **Cart** y **Order**, necesita generar un token a través de [Create user token](https://developers.xsolla.com/es/digital-distribution-hub/common/user-token/create-user-token).
Nota

Esta referencia muestra un diseño de una futura API y no una interfaz plenamente funcional. Actualmente, solo puede probar los puntos finales de los grupos Catalog y Notifications. Si desea compartir sus comentarios, envíenos un correo electrónico a techdoc@xsolla.com.
Version: 1.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForClient Utilice el punto final [Create user token](https://developers.xsolla.com\/es/api/digital-distribution-hub/operation/create-user-token) para generar un token. Type: http Scheme: bearer ### basicAuth 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 `distribution_hub_id:api_key` codificado según el estándar Base64. Contacte con su gestor de cuenta para obtener `distribution_hub_id` y `api_key`. Type: http Scheme: basic ## Download OpenAPI description [Digital Distribution Hub](https://developers.xsolla.com/_bundle/@l10n/es/api/digital-distribution-hub/index.yaml) ## Cesta ### Obtener la cesta del usuario actual - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/es/api/digital-distribution-hub/cart/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/digital-distribution-hub/cart/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/digital-distribution-hub/cart/cart-fill.md): Llena la cesta con artículos. Si la cesta ya tiene un artículo con el mismo código de artículo (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/digital-distribution-hub/cart/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/digital-distribution-hub/cart/put-item.md): Actualiza un artículo de la cesta existente o crea uno 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/digital-distribution-hub/cart/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/digital-distribution-hub/cart/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/digital-distribution-hub/cart/cart-fill-by-id.md): Llena la cesta específica con artículos. Si la cesta ya contiene un artículo con el mismo código de artículo (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/digital-distribution-hub/cart/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/digital-distribution-hub/cart/put-item-by-cart-id.md): Actualiza un artículo de la cesta existente o crea uno de la cesta. ## Claves del juego ### Obtener lista de juegos - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/es/api/digital-distribution-hub/game-keys/get-games-list.md): Obtiene una lista de juegos para crear un catálogo. Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset. ### Obtener lista de sistemas de DRM - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/es/api/digital-distribution-hub/game-keys/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/digital-distribution-hub/game-keys/get-games-group.md): Obtiene una lista de juegos del grupo especificado para crear un catálogo. Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset. ### Obtener la lista de claves del juego por grupo especificado - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/es/api/digital-distribution-hub/game-keys/get-game-keys-group.md): Obtiene una lista de claves del juego del grupo especificado para crear un catálogo. Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset. ### 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/digital-distribution-hub/game-keys/get-game-key-by-sku.md): Obtiene una clave del juego para el catálogo. ### Obtener juego para el catálogo - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/es/api/digital-distribution-hub/game-keys/get-game-by-sku.md): Obtiene un juego para el catálogo. ## Árticulos y moneda virtuales ### Obtener lista de grupos de artículos - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/es/api/digital-distribution-hub/virtual-items-and-currency/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/digital-distribution-hub/virtual-items-and-currency/get-virtual-currency.md): Obtiene una lista de monedas virtuales para crear un catálogo. Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset. ### Obtener la lista de paquetes de moneda virtual - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/es/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-currency-package.md): Obtiene una lista de paquetes de moneda virtual para crear un catálogo. Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset. ### Obtener lista de artículos virtuales - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/es/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-items.md): Obtiene una lista de artículos virtuales para crear un catálogo. Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset. ### 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/digital-distribution-hub/virtual-items-and-currency/get-virtual-items-group.md): Obtiene una lista de artículos del grupo especificado para crear un catálogo. Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset. ## Lotes ### Obtener lista de lotes - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/es/api/digital-distribution-hub/bundles/get-bundle-list.md): Obtiene una lista de lotes para generar un catálogo. Atención. Todos 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. ### Obtener el lote especificado - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/es/api/digital-distribution-hub/bundles/get-bundle.md): Obtiene un lote especificado. ## Token del usuario ### Crear token de usuario - [POST /v2/project/{project_id}/distribution_hub/user/auth](https://developers.xsolla.com/es/api/digital-distribution-hub/user-token/create-user-token.md): Verifica que un usuario existe en el juego y crea un token de usuario. ## Notificaciones ### Cancel notification (Cancelar notificación) - [POST /push-payments/cancel](https://developers.xsolla.com/es/api/digital-distribution-hub/notifications/cancel-notification.md): Envíe la notificación sobre la cancelación del pago si: - el pago no se completó - el pago fue reembolsado ### Notificación de pago - [POST /push-payments/pay](https://developers.xsolla.com/es/api/digital-distribution-hub/notifications/pay-notification.md): Envía esta notificación después de cobrar un importe correctamente a un usuario. ## Pedido ### Obtener pedido - [GET /v2/project/{project_id}/distribution_hub/order/{order_id}](https://developers.xsolla.com/es/api/digital-distribution-hub/order/get-order.md): Recupera un pedido especificado. ### Crear pedido con todos los artículos de la cesta actual - [POST /v2/project/{project_id}/distribution_hub/payment/cart](https://developers.xsolla.com/es/api/digital-distribution-hub/order/create-order.md): Crea un pedido con todos los artículos de la cesta. El pedido creado obtendrá el estado de pedido new. ### Crear pedido con todos los artículos de una cesta específica - [POST /v2/project/{project_id}/distribution_hub/payment/cart/{cart_id}](https://developers.xsolla.com/es/api/digital-distribution-hub/order/create-order-by-cart-id.md): Crea un pedido con todos los artículos de la cesta específica. El pedido creado obtendrá el estado de pedido new. ### Crear pedido con un artículo especificado - [POST /v2/project/{project_id}/distribution_hub/payment/item/{item_sku}](https://developers.xsolla.com/es/api/digital-distribution-hub/order/create-order-with-item.md): Crea un pedido con un artículo especificado. El pedido creado obtendrá el estado de pedido new.