Registro de cambios de la API

Actualización de la v1 - julio de 2026

Adiciones aditivas de códigos de error y campos de respuesta al contrato v1 existente.

• Nuevo error 422 withdrawal_consent_required en el endpoint de download-urls de pedidos: se devuelve 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.
• Nuevo error 422 key_limit_reached al crear claves de API: una tienda puede tener como máximo 25 claves de API activas; revoca una primero.
• Nuevo error 409 delivery_not_yet_released en los endpoints download-urls y resend de pedidos: se devuelve cuando el producto tiene configurado un retraso de entrega de la descarga y los archivos del comprador aún no se han desbloqueado. No se emite ninguna URL de descarga ni se envía ningún correo hasta que transcurre el retraso.
• Nuevo objeto error.details en el sobre de error: solo está presente en los códigos que aportan contexto seguro para quien llama. Hoy delivery_not_yet_released es el único que lo produce, y lleva release_at, el instante ISO 8601 en el que se desbloquean las descargas. Trata el objeto como abierto: pueden aparecer claves nuevas sin un cambio de versión mayor.
• Nuevos campos delivery_pending y release_at en el objeto de compra del estado del pedido: delivery_pending es true mientras una compra sigue retenida por un retraso de entrega de la descarga, y release_at es el instante ISO 8601 de desbloqueo, o null cuando no hay nada pendiente.
• El endpoint grant-downloads ahora libera de inmediato las compras retenidas del pedido, de modo que un comerciante puede anular un retraso de entrega de la descarga a través de la API.

v1.0.0 - junio de 2026

Superficie inicial de la API piloto, con acceso solo mediante aprobación.

• Claves de API para tiendas aprobadas.
• Claves de idempotencia obligatorias en las solicitudes de escritura.
• Importación de recursos desde URL remota, subidas directas, listado de recursos, actualizaciones de recursos y eliminación de recursos.
• Categorías planas, asignaciones de productos, packs y etiquetas de claves de licencia.
• Asignaciones de pedidos que hacen visibles las descargas mapeadas en las cuentas de cliente de Shopify.
• Controles de acceso a pedidos: revocar, restaurar, conceder descargas y reenviar el email.
• Endpoints de estado de trabajos y pedidos.
• Descargas de la especificación OpenAPI y la colección de Postman.

Política de versionado

El contrato de la v1 es solo aditivo: pueden añadirse nuevos endpoints, campos opcionales y nuevos códigos de error. Los cambios incompatibles usarán una futura ruta /api/v2.