# DZBuild API reference (French) > Reference for the DZBuild REST API v1: authentication, resources, webhooks and errors. Every link is the Markdown version of a page. All sections: https://dzbuild.com/fr/llms.txt ## General - [Authentification](https://dzbuild.com/fr/api-docs/authentication.md): Apprenez à 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 DZBuild. - [Journal des modifications](https://dzbuild.com/fr/api-docs/changelog.md): L'API est en pilote. Les clés API personnelles doivent appartenir à une boutique disposant d'un plan Enterprise actif, sans quoi chaque appel renvoie 403 ; les jetons d'application installée fonctionnent avec tous les plans. https://api.dzbuild.app est le seul hôte pris en charge. - [Erreurs](https://dzbuild.com/fr/api-docs/errors.md): Ré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. - [Idempotence](https://dzbuild.com/fr/api-docs/idempotency.md): Chaque 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. - [API DZBuild](https://dzbuild.com/fr/api-docs/intro.md): Construisez sur DZBuild — API REST complète pour boutiques, produits, commandes, clients, landing pages, inscriptions et webhooks. - [Pagination](https://dzbuild.com/fr/api-docs/pagination.md): Dé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. - [DZBuild POS](https://dzbuild.com/fr/api-docs/pos.md): Comment 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'événements. - [Limites de taux](https://dzbuild.com/fr/api-docs/rate-limits.md): Limites 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. ## guides - [Découverte par les agents](https://dzbuild.com/fr/api-docs/guides/agent-discovery.md): Où 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 suivent. - [Thèmes & vitrines personnalisés](https://dzbuild.com/fr/api-docs/guides/custom-storefronts.md): Construisez une vitrine entièrement personnalisée en React, Vue, Next.js, Flutter ou n'importe quelle stack — alimentée par l'API DZBuild. - [Environnement & .env](https://dzbuild.com/fr/api-docs/guides/env-setup.md): Comment stocker en sécurité les credentials de l'API DZBuild dans votre application — des fichiers .env aux KMS jusqu'aux GitHub Secrets. - [Pour les revendeurs](https://dzbuild.com/fr/api-docs/guides/resellers.md): Comment utiliser l'API DZBuild pour revendre des boutiques, gérer des clients à grande échelle et intégrer votre back-office. ## public-key - [POST /v1/events](https://dzbuild.com/fr/api-docs/public-key/events.md): POST /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. - [POST /v1/signups](https://dzbuild.com/fr/api-docs/public-key/signups.md): POST /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. ## resources - [Analytics](https://dzbuild.com/fr/api-docs/resources/analytics.md): Lisez les chiffres du tableau de bord d'une boutique sur une période avec GET /v1/analytics : commandes, revenu, profit, visiteurs, variation et graphiques. - [Catégories](https://dzbuild.com/fr/api-docs/resources/categories.md): Listez, 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. - [Changements et annulation](https://dzbuild.com/fr/api-docs/resources/changes.md): Listez 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. - [Clients](https://dzbuild.com/fr/api-docs/resources/customers.md): Consultez votre liste clients, recherchez par téléphone ou email, voyez toutes les commandes d'un client. - [Sections de la page d'accueil](https://dzbuild.com/fr/api-docs/resources/home-layout.md): Lisez et modifiez les sections d'accueil d'une boutique depuis votre code avec dix types, puis ajoutez, masquez, réordonnez, supprimez ou annulez. - [Clés (vos propres clés)](https://dzbuild.com/fr/api-docs/resources/keys.md): Créez, listez et révoquez les clés API de votre boutique. Clés plateforme (Bearer) et clés publiques (HMAC). - [Landing pages](https://dzbuild.com/fr/api-docs/resources/landing-pages.md): CRUD pour les landing pages — pages de conversion mono-produit avec sections (carrousels, formulaires de commande, faux visiteurs, comptes à rebours, offres spéciales). - [Menus de la boutique](https://dzbuild.com/fr/api-docs/resources/menus.md): Lisez et remplacez depuis votre code les liens de la barre de navigation et du pied de page en un seul document, avec un contrôle de version et l'annulation. - [Commandes](https://dzbuild.com/fr/api-docs/resources/orders.md): Créer, lire, transitionner et annuler des commandes. Support complet des variantes, paniers multi-lignes, tarification autoritative côté serveur. - [Pages de la boutique](https://dzbuild.com/fr/api-docs/resources/pages.md): Listez, lisez, créez, modifiez et supprimez les pages Markdown d'une boutique depuis votre code, comme À propos ou Retours, puis annulez un changement. - [Pixels de suivi](https://dzbuild.com/fr/api-docs/resources/pixels.md): Listez, 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é. - [Produits](https://dzbuild.com/fr/api-docs/resources/products.md): CRUD complet pour le catalogue produits — liste, détail, création, mise à jour, suppression. Avec variantes, images, limites par plan. - [Codes promo](https://dzbuild.com/fr/api-docs/resources/promo-codes.md): Listez, 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. - [Quotas](https://dzbuild.com/fr/api-docs/resources/quotas.md): Voyez les limites du tier Enterprise, les overrides éventuels par boutique mis par le support, et vos limites effectives. - [Livraison](https://dzbuild.com/fr/api-docs/resources/shipping.md): Lisez et modifiez les tarifs de livraison par wilaya et la livraison gratuite, liez, testez et synchronisez les transporteurs, et listez wilayas et communes. - [Boutique](https://dzbuild.com/fr/api-docs/resources/store.md): GET /v1/store — profil de votre boutique (nom, slug, thème, domaine personnalisé, URL publique). - [Thèmes](https://dzbuild.com/fr/api-docs/resources/themes.md): Listez 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. - [Utilisation](https://dzbuild.com/fr/api-docs/resources/usage.md): Consultez votre consommation API du mois en cours et les agrégats horaires historiques. - [Messages WhatsApp](https://dzbuild.com/fr/api-docs/resources/whatsapp.md): Lisez 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. ## webhooks - [Catalogue d'événements](https://dzbuild.com/fr/api-docs/webhooks/events.md): Tous les événements webhook que DZBuild peut déclencher, avec la forme exacte du champ data de chaque payload. - [Webhooks](https://dzbuild.com/fr/api-docs/webhooks/overview.md): Comment fonctionnent les webhooks DZBuild — quels événements se déclenchent, livraison + retries, modèle de sécurité, quotas. - [Enregistrer un webhook](https://dzbuild.com/fr/api-docs/webhooks/registering.md): Créer, lister, tester et supprimer des abonnements webhook pour votre boutique. - [Vérifier les signatures](https://dzbuild.com/fr/api-docs/webhooks/verifying-signatures.md): Comment authentifier les webhooks DZBuild entrants. Comparaison HMAC à temps constant + check de fraîcheur, avec code copy-paste en Node.js, PHP, Python et Go.