L'API est en pilote et réservée au plan Enterprise : les clés doivent être inscrites au pilote et appartenir à une boutique disposant d'un plan Enterprise actif, sans quoi chaque appel renvoie 403, et https://api.dzbuild.app est le seul hôte pris en charge.
v1.3 — 2026-08-13 (pilote)
✨ Gestion des clés en libre-service — les propriétaires de boutiques Enterprise peuvent désormais générer et révoquer leurs clés API depuis le dashboard marchand, dans Paramètres → API (
/dashboard/api). Les secrets ne sont affichés qu'une fois, à la création.⚠️ La limite de taux par minute est désormais appliquée par boutique, partagée entre toutes les clés de la boutique (auparavant par clé). Le plafond Enterprise reste inchangé à 600 requêtes/minute.
⚠️ Une boutique peut désormais détenir au plus 3 clés actives (contre 20), quel que soit le canal de création — dashboard,
POST /v1/keysou support. Révoquer une clé libère sa place.
v1.2 — 2026-08-13 (pilote)
⚠️ L'API est désormais réservée au plan Enterprise. Les clés ne s'authentifient que tant que leur boutique est sur un plan Enterprise actif ; tout autre plan — ainsi qu'un abonnement Enterprise expiré — reçoit
403 forbidden(« API access requires an active Enterprise plan »). Les nouvelles clés ne peuvent être créées que pour des boutiques Enterprise. Les clés existantes des boutiques non-Enterprise cessent de fonctionner immédiatement mais ne sont pas supprimées : elles reprennent dès que la boutique passe sur (ou renouvelle) Enterprise, sans rien à réémettre.⚠️ Les tiers de limite de taux hérités Free / Pro / Unlimited sont retirés. Le plafond Enterprise reste 600 requêtes/minute par clé sans plafond mensuel ; les surcharges par boutique du support s'appliquent toujours.
v1.1 — 2026-08-12 (pilote)
✨ Images produits via l'API —
POST /v1/products/{id}/imagesajoute une image depuis une URLhttpspublique (DZBuild la télécharge, l'optimise et l'héberge),PATCH .../images/{image_id}définit le texte alternatif, l'ordre d'affichage et l'image principale,DELETE .../images/{image_id}en supprime une. Les URL en double sont dédupliquées, la première image devient automatiquement l'image principale, maximum 20 images par produit.✨
PUT /v1/products/{id}/variants— créez et gérez les groupes de variantes, leurs options et le stock par combinaison en un seul appel (remplacement complet). Les champsprice_adjustment,stock,sku,image_idetshow_as_cardpar option sont désormais modifiables, et les indicateurs de mode de stock sont réglés pour vous.✨
GET /v1/products/{id}renvoie maintenant le bloccombinationsainsi que les champs d'option complets (price_adjustment,sku,show_as_card,sort_order,is_active) et lealt_textdes images.⚠️ Changement notable :
primary_imageetimages[].urlrenvoient désormais des URL CDN complètes au lieu de noms de fichiers nus. Si votre code ajoute le préfixe manuellement, retirez cette logique.
v1.0.1 — 2026-05-02 (pilote)
✨
POST /v1/orders— création de commandes via l'API. Conçu pour les thèmes personnalisés, les vitrines headless, les apps mobiles et l'automatisation des revendeurs. Tarification des lignes autoritative côté serveur ; support complet des variantes ; idempotent.📚 Nouveau guide : Thèmes & vitrines personnalisés — build de bout en bout : catalogue, UI variantes, panier, checkout, intégration webhooks.
📚 Nouveau guide : Pour revendeurs — gérer plusieurs boutiques clients, opérations en bulk, white-label, modèles de facturation.
📚 Nouveau guide : Environnement & .env — stockage sécurisé des credentials pour Node, Python, PHP, Go, Vercel, Cloudflare, AWS, Docker/K8s, GitHub Actions.
📚 Référence
Ordersenrichie — documentation complète des variantes : stock par variante, par combinaison, variantes en cascade, variantes image-texte, offres multi-pièces.
v1.0 — 2026-04-30 (pilote)
🎉 Lancement initial en pilote.
Authentification, limitation de taux et cache de lecture, par clé.
Endpoints de lecture : boutique / produits / commandes / clients / landing pages.
Endpoints d'écriture avec idempotence : produits / commandes / landing pages.
Ingestion asynchrone de
/v1/signupset/v1/events(202 Accepted).Webhooks sortants avec réessais automatiques.