Aller au contenu principal
- Référence des endpoints

Référence des endpoints de l'API

Voici les endpoints destinés aux clients dans la première version de l'API. Tous les chemins sont relatifs à https://<app-host>/api/v1.

Assets

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.

Catégories, mappings, packs et étiquettes

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.

Commandes et accès

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.

L'endpoint download-urls renvoie 422 withdrawal_consent_required lorsque la boutique a activé le consentement au droit de rétractation UE et que la commande n'a pas encore d'enregistrement de consentement ; les URL de téléchargement sont émises dès que le client donne son consentement.

Les endpoints download-urls et resend renvoient 409 delivery_not_yet_released lorsque le produit a un délai de livraison du téléchargement configuré et que les fichiers de l'acheteur ne sont pas encore débloqués. La valeur error.details.release_at est l'instant ISO 8601 du déblocage, et l'endpoint grant-downloads libère la commande par anticipation.

Santé et statut

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

Documentation de l'API

Cet article vous a-t-il été utile ?

Toujours bloqué ? Écrivez à admin@alvaapps.com.

Dernière mise à jour 2026-06-05