Journal des versions de l'API

Mise à jour v1 - juillet 2026

Ajouts additifs de codes d'erreur et de champs de réponse au contrat v1 existant.

• Nouvelle erreur 422 withdrawal_consent_required sur l'endpoint download-urls des commandes : renvoyée 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.
• Nouvelle erreur 422 key_limit_reached à la création de clés API : une boutique peut détenir au plus 25 clés API actives ; révoquez-en une d'abord.
• Nouvelle erreur 409 delivery_not_yet_released sur les endpoints download-urls et resend des commandes : renvoyée 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. Aucune URL de téléchargement n'est émise et aucun e-mail n'est envoyé tant que le délai n'est pas écoulé.
• Nouvel objet error.details dans l'enveloppe d'erreur : présent uniquement sur les codes qui transportent un contexte sûr pour l'appelant. Aujourd'hui, delivery_not_yet_released est le seul à le produire, et il contient release_at, l'instant ISO 8601 auquel les téléchargements se débloquent. Considérez cet objet comme ouvert : de nouvelles clés peuvent apparaître sans changement de version majeure.
• Nouveaux champs delivery_pending et release_at sur l'objet achat du statut de commande : delivery_pending vaut true tant qu'un achat est encore retenu par un délai de livraison du téléchargement, et release_at est l'instant ISO 8601 du déblocage, ou null lorsque rien n'est en attente.
• L'endpoint grant-downloads libère désormais immédiatement les achats retenus de la commande, ce qui permet à un marchand de passer outre un délai de livraison du téléchargement via l'API.

v1.0.0 - juin 2026

Surface initiale de l'API pilote, en accès sur approbation uniquement.

• Clés d'API pour les boutiques approuvées.
• Clés d'idempotence requises sur les requêtes d'écriture.
• Import d'assets par URL distante, téléversements directs, liste des assets, mises à jour d'assets et suppression d'assets.
• Catégories à plat, mappings de produits, packs et étiquettes de clés de licence.
• Attributions de commandes qui rendent les téléchargements mappés visibles dans les comptes clients Shopify.
• Contrôles d'accès aux commandes : révoquer, restaurer, accorder des téléchargements et renvoyer l'e-mail.
• Endpoints de statut des tâches et des commandes.
• Téléchargements de la spécification OpenAPI et de la collection Postman.

Politique de versionnage

Le contrat v1 est additif uniquement : de nouveaux endpoints, des champs optionnels et de nouveaux codes d'erreur peuvent être ajoutés. Les changements incompatibles utiliseront un futur chemin /api/v2.