Recursos
| Método | Ruta | Propósito |
|---|
| POST | /assets | Importar una URL remota como asset. |
| POST | /assets/uploads | Iniciar una subida directa. |
| POST | /assets/uploads/{uploadId}/complete | Finalizar una subida directa. |
| GET | /assets | Listar assets. |
| GET/PATCH/DELETE | /assets/{id} | Leer, actualizar o eliminar un asset. |
Categorías, asignaciones, packs, enlaces y etiquetas
| Método | Ruta | Propósito |
|---|
| GET/POST | /categories | Listar o crear categorías planas. |
| GET/PATCH/DELETE | /categories/{id} | Leer, renombrar o eliminar una categoría. |
| GET/POST | /mappings | Listar o insertar/actualizar asignaciones de productos de Shopify. |
| GET/PUT/DELETE | /mappings/{id} | Leer, reemplazar o eliminar una asignación. |
| GET/POST | /packs | Listar o crear packs. |
| GET/DELETE | /packs/{id} | Leer o eliminar un pack. |
| GET/POST | /links | Listar o crear enlaces. Crear requiere un plan de pago; los límites de visitas y la caducidad siguen siendo exclusivos del admin. |
| GET/POST | /license-key-tags | Listar o crear etiquetas de claves de licencia. |
Pedidos y acceso
| Método | Ruta | Propósito |
|---|
| GET | /orders/{shopify_order_id} | Leer el estado de descarga de un pedido. |
| GET/POST | /orders/{shopify_order_id}/assignments | Listar o crear asignaciones a nivel de producto. |
| GET | /orders/{shopify_order_id}/assignments/{purchaseId}/download-urls | Generar URLs de descarga. |
| POST | /orders/{shopify_order_id}/revoke | Desactivar el acceso. |
| POST | /orders/{shopify_order_id}/restore | Restaurar el acceso. |
| POST | /orders/{shopify_order_id}/grant-downloads | Conceder descargas adicionales. |
| POST | /orders/{shopify_order_id}/resend | Reenviar el email de entrega. |
El endpoint de download-urls devuelve 422 withdrawal_consent_required cuando la tienda tiene activado el consentimiento del derecho de desistimiento de la UE y el pedido aún no tiene un registro de consentimiento; las URL de descarga se emiten en cuanto el cliente da su consentimiento.
Los endpoints download-urls y resend devuelven 409 delivery_not_yet_released cuando el producto tiene configurado un retraso de entrega de la descarga y los archivos del comprador aún no se han desbloqueado. El valor error.details.release_at es el instante ISO 8601 en el que se desbloquean, y el endpoint grant-downloads libera el pedido antes de tiempo.
Salud y estado
| Método | Ruta | Propósito |
|---|
| GET | /health | Comprobar la disponibilidad de la API. |
| GET | /ping | Comprobar la autenticación. |
| GET | /jobs/{jobId} | Leer el estado de un trabajo asíncrono. |
Última actualización 2026-06-05