Saltar al contenido principal
- Referencia de endpoints

Referencia de endpoints de la API

Estos son los endpoints orientados al cliente en la primera versión de la API. Todas las rutas son relativas a https://<app-host>/api/v1.

Recursos

MethodPathPurpose
POST/assetsImport a remote URL as an asset.
POST/assets/uploadsBegin a direct upload.
POST/assets/uploads/{uploadId}/completeFinalize a direct upload.
GET/assetsList assets.
GET/PATCH/DELETE/assets/{id}Read, update, or delete an asset.

Categorías, asignaciones, packs y etiquetas

MethodPathPurpose
GET/POST/categoriesList or create flat categories.
GET/PATCH/DELETE/categories/{id}Read, rename, or delete a category.
GET/POST/mappingsList or upsert Shopify product mappings.
GET/PUT/DELETE/mappings/{id}Read, replace, or delete a mapping.
GET/POST/packsList or create packs.
GET/DELETE/packs/{id}Read or delete a pack.
GET/POST/license-key-tagsList or create license-key tags.

Pedidos y acceso

MethodPathPurpose
GET/orders/{shopify_order_id}Read order download status.
GET/POST/orders/{shopify_order_id}/assignmentsList or create product-level assignments.
GET/orders/{shopify_order_id}/assignments/{purchaseId}/download-urlsMint download URLs.
POST/orders/{shopify_order_id}/revokeDisable access.
POST/orders/{shopify_order_id}/restoreRestore access.
POST/orders/{shopify_order_id}/grant-downloadsGrant extra downloads.
POST/orders/{shopify_order_id}/resendResend the delivery email.

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

MethodPathPurpose
GET/healthCheck API availability.
GET/pingCheck authentication.
GET/jobs/{jobId}Read async job status.

Documentación de la API

¿Te ha resultado útil?

¿Sigues con dudas? Escribe a admin@alvaapps.com.

Última actualización 2026-06-05