# DZBuild Developers

> Developer documentation for DZBuild, the e-commerce platform for Algerian merchants. Third-party apps use OAuth 2.0 with PKCE to get one install token per store, call the REST API at https://api.dzbuild.app/v1 and receive webhooks signed with X-DZ-Signature.


## fr

- [Créez des applications pour les boutiques DZBuild](https://dzbuild.dev/fr/index.md): Plateforme développeur de DZBuild, la plateforme e-commerce des marchands algériens. Applications OAuth, un jeton d'installation par boutique, une API REST pour les commandes, les produits, la livraison et WhatsApp, et des webhooks signés.
- [Référence de l'API](https://dzbuild.dev/fr/api-reference.md): Où trouver la référence de l'API REST DZBuild en français, en arabe et en anglais, et comment télécharger la description OpenAPI pour vos outils.
- [Développer avec des agents IA](https://dzbuild.dev/fr/build-with-ai.md): Utilisez Claude Code, Codex, Cursor, ChatGPT ou tout agent de code pour créer une application DZBuild. Où trouver les pages Markdown, llms.txt, la compétence agent et la description OpenAPI, et comment garder les secrets hors du chat.
- [Journal des modifications](https://dzbuild.dev/fr/changelog.md): Les changements datés de la plateforme développeurs DZBuild : nouveaux scopes, endpoints, événements webhook et changements pour les applications installées.
- [Concepts clés](https://dzbuild.dev/fr/concepts.md): Le fonctionnement des applications DZBuild : installations, boutiques, plans, le réglage min_plan et la limite de requêtes propre à chaque installation.
- [Erreurs](https://dzbuild.dev/fr/errors.md): Toutes les erreurs qu'une application DZBuild peut rencontrer, sur une page. L'enveloppe d'erreur de l'API, les codes 400 à 502 avec leurs messages, les erreurs OAuth d'autorisation et d'échange, les codes WhatsApp et les échecs de livraison des webhooks.
- [Questions fréquentes](https://dzbuild.dev/fr/faq.md): Réponses courtes sur la création d'applications pour les boutiques DZBuild. Ce qu'est une application, qui peut en créer une, les plans, l'expiration des jetons, les tests en local, les messages WhatsApp, les événements webhook, la vérification et le développement assisté par IA.
- [Premiers pas](https://dzbuild.dev/fr/getting-started.md): Créez votre première application DZBuild : enregistrez-la dans la console, choisissez les scopes, installez-la sur votre boutique et faites un premier appel.
- [Sections de la page d'accueil](https://dzbuild.dev/fr/home-layout.md): Lisez et modifiez les sections d'accueil d'une boutique depuis votre application, avec les dix types, les six endpoints, l'annulation et les erreurs.
- [Documentation développeur DZBuild](https://dzbuild.dev/fr/intro.md): Créez des applications pour les boutiques DZBuild : enregistrez une application OAuth, installez-la sur une boutique, appelez l'API REST, recevez des webhooks.
- [Flux d'installation OAuth](https://dzbuild.dev/fr/oauth.md): Le flux OAuth des applications DZBuild : paramètres d'autorisation, consentement du marchand, PKCE en S256, échange du code et chaque code d'erreur.
- [Limites de requêtes](https://dzbuild.dev/fr/rate-limits.md): Les limites des jetons d'application DZBuild : quota par installation, quota de la boutique, en-tête Idempotency-Key et réponses 402 et 429 à gérer.
- [Règles de vérification](https://dzbuild.dev/fr/review-guidelines.md): Ce que DZBuild vérifie avant d'ouvrir une application à tous les marchands, et comment préparer votre application, sa fiche et son support.
- [Scopes](https://dzbuild.dev/fr/scopes.md): Les scopes qu'une application DZBuild peut demander, ce que chacune ouvre dans l'API REST et comment le marchand les voit à l'écran de consentement.
- [Exigences de sécurité](https://dzbuild.dev/fr/security.md): Les règles de sécurité de toute application DZBuild : adresses de redirection exactes, client secret côté serveur, webhooks vérifiés et suppression des données.
- [Webhooks](https://dzbuild.dev/fr/webhooks.md): Recevez des webhooks DZBuild signés dans votre application : liste des événements, en-tête X-DZ-Signature, fenêtre anti-rejeu et exemples de vérification.
- [API WhatsApp](https://dzbuild.dev/fr/whatsapp.md): Envoyez depuis votre application les modèles WhatsApp de commande approuvés par la plateforme, payés par le solde de la boutique, et lisez modèles et messages.