API développeur
Par Support1 auteur35 articles
- API DZBuild — IntroductionConstruisez sur DZBuild — API REST complète pour boutiques, produits, commandes, clients, landing pages, inscriptions et webhooks.
- AuthentificationApprenez à authentifier les requêtes API avec les clés de plateforme et les clés publiques, y compris les Bearer tokens et les signatures HMAC pour un accès sécurisé à l'API…
- Limites de tauxLimites de taux de l'API DZBuild : accès réservé au plan Enterprise, plafond par minute par boutique, budgets des endpoints coûteux, et pourquoi votre vitrine n'est jamais affectée.
- IdempotenceChaque requête POST, PATCH et DELETE vers l'API DZBuild nécessite un en-tête Idempotency-Key, et PUT l'accepte aussi, pour qu'un réessai avec la même clé n'exécute jamais une écriture deux fois.
- ErreursRéférence complète des codes d'erreur DZBuild API, codes HTTP, format de réponse d'erreur et gestion des erreurs dans votre intégration.
- PaginationDécouvrez comment l'API DZBuild utilise la pagination par curseur pour les endpoints de liste — récupération efficace de données via next_cursor et has_more.
- BoutiqueGET /v1/store — profil de votre boutique (nom, slug, thème, domaine personnalisé, URL publique).
- ProduitsCRUD complet pour le catalogue produits — liste, détail, création, mise à jour, suppression. Avec variantes, images, limites par plan.
- CommandesCréer, lire, transitionner et annuler des commandes. Support complet des variantes, paniers multi-lignes, tarification autoritative côté serveur.
- ClientsConsultez votre liste clients, recherchez par téléphone ou email, voyez toutes les commandes d'un client.
- Landing pagesCRUD pour les landing pages — pages de conversion mono-produit avec sections (carrousels, formulaires de commande, faux visiteurs, comptes à rebours, offres spéciales).
- Clés (vos propres clés)Créez, listez et révoquez les clés API de votre boutique. Clés plateforme (Bearer) et clés publiques (HMAC).
- UtilisationConsultez votre consommation API du mois en cours et les agrégats horaires historiques.
- QuotasVoyez les limites du tier Enterprise, les overrides éventuels par boutique mis par le support, et vos limites effectives.
- InscriptionsPOST /v1/signups — comptez une inscription d'utilisateur final dans votre quota mensuel. L'unité métrée principale. Signée HMAC, acceptée de façon asynchrone, dédupliquée par nonce + email.
- ÉvénementsPOST /v1/events — événements génériques trackés par le marchand (vues de page, leads, analytics custom). Même schéma HMAC que les inscriptions, sans dédup email/phone.
- Thèmes & vitrines personnalisésConstruisez une vitrine entièrement personnalisée en React, Vue, Next.js, Flutter ou n'importe quelle stack — alimentée par l'API DZBuild.
- Pour les revendeursComment utiliser l'API DZBuild pour revendre des boutiques, gérer des clients à grande échelle et intégrer votre back-office.
- Environnement & .envComment stocker en sécurité les credentials de l'API DZBuild dans votre application — des fichiers .env aux KMS jusqu'aux GitHub Secrets.
- Vue d'ensemble des WebhooksComment fonctionnent les webhooks DZBuild — quels événements se déclenchent, livraison + retries, modèle de sécurité, quotas.
- Enregistrer un webhookCréer, lister, tester et supprimer des abonnements webhook pour votre boutique.
- Catalogue d'événementsTous les événements webhook que DZBuild peut déclencher, avec la forme exacte du champ data de chaque payload.
- Vérifier les signaturesComment authentifier les webhooks DZBuild entrants. Comparaison HMAC à temps constant + check de fraîcheur, avec code copy-paste en Node.js, PHP, Python et Go.
- Journal des modifications
- Messages WhatsAppLisez les modèles WhatsApp de commande, le solde WhatsApp et l'historique des messages, et envoyez un modèle à l'acheteur d'une commande depuis votre code.
- Sections de la page d'accueilLisez et modifiez les sections d'accueil d'une boutique depuis votre code avec dix types, puis ajoutez, masquez, réordonnez, supprimez ou annulez.
- ThèmesListez les thèmes de boutique, les thèmes Fast Checkout et les styles de variantes qu'une boutique peut utiliser, puis changez chacun depuis votre propre code.
- CatégoriesListez, lisez, créez, renommez, déplacez, supprimez et réordonnez les catégories de produits d'une boutique depuis votre code, puis annulez un changement.
- Codes promoListez, créez, modifiez et supprimez les codes promo d'une boutique depuis votre code, avec la règle de l'add-on, la confirmation à 100% et l'annulation.
- Pixels de suiviListez, ajoutez, modifiez et supprimez les pixels Meta, TikTok, Snapchat, Pinterest et Google d'une boutique par l'API. Le token d'accès n'est jamais renvoyé.
- LivraisonLisez et modifiez les tarifs de livraison par wilaya et la livraison gratuite, liez, testez et synchronisez les transporteurs, et listez wilayas et communes.
- AnalyticsLisez les chiffres du tableau de bord d'une boutique sur une période avec GET /v1/analytics : commandes, revenu, profit, visiteurs, variation et graphiques.
- Changements et annulationListez les changements de configuration faits par l'API, lisez-en un avec les valeurs qu'il a remplacées, puis annulez-le pour remettre ces valeurs en boutique.
- DZBuild POSComment la caisse Windows gratuite DZBuild POS se relie à une boutique, et les appels qu'elle fait pour les produits, photos, stock, documents de vente, commandes, clients et le flux…
- Découverte par les agentsOù les agents et assistants IA trouvent les fichiers machine de DZBuild, le connecteur MCP, la description de l'API REST et le catalogue de chaque boutique, et les règles qu'ils…