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 à votre URL de base de l'API, que l'application affiche sous Paramètres → API keys une fois que vous avez créé une clé.

Assets

MéthodeCheminObjet
POST/assetsImporter une URL distante en tant qu'asset.
POST/assets/uploadsDémarrer un téléversement direct.
POST/assets/uploads/{uploadId}/completeFinaliser un téléversement direct.
GET/assetsLister les assets.
GET/PATCH/DELETE/assets/{id}Lire, mettre à jour ou supprimer un asset.

Catégories, mappings, packs, liens et étiquettes

MéthodeCheminObjet
GET/POST/categoriesLister ou créer des catégories plates.
GET/PATCH/DELETE/categories/{id}Lire, renommer ou supprimer une catégorie.
GET/POST/mappingsLister ou créer/mettre à jour des associations de produits Shopify.
GET/PUT/DELETE/mappings/{id}Lire, remplacer ou supprimer une association.
GET/POST/packsLister ou créer des packs.
GET/DELETE/packs/{id}Lire ou supprimer un pack.
GET/POST/linksLister ou créer des liens. La création requiert un plan payant ; les limites de visites et l'expiration restent réservées à l'admin.
GET/POST/license-key-tagsLister ou créer des étiquettes de clés de licence.

Commandes et accès

MéthodeCheminObjet
GET/orders/{shopify_order_id}Lire l'état de téléchargement d'une commande.
GET/POST/orders/{shopify_order_id}/assignmentsLister ou créer des affectations au niveau produit.
GET/orders/{shopify_order_id}/assignments/{purchaseId}/download-urlsGénérer des URL de téléchargement.
POST/orders/{shopify_order_id}/revokeDésactiver l'accès.
POST/orders/{shopify_order_id}/restoreRétablir l'accès.
POST/orders/{shopify_order_id}/grant-downloadsAccorder des téléchargements supplémentaires.
POST/orders/{shopify_order_id}/resendRenvoyer l'e-mail de livraison.

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

MéthodeCheminObjet
GET/healthVérifier la disponibilité de l'API.
GET/pingVérifier l'authentification.
GET/jobs/{jobId}Lire l'état d'une tâche asynchrone.

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