# Documentation développeur DZBuild

DZBuild ([dzbuild.com](https://dzbuild.com)) est la plateforme e-commerce des marchands algériens : boutiques en ligne avec paiement à la livraison, livraison par transporteur dans les wilayas, pages de destination et messages WhatsApp de commande. Une application DZBuild est un service que vous hébergez sur vos propres serveurs. Le propriétaire d'une boutique l'installe, puis votre serveur lit et modifie les données de cette boutique via l'API REST. Aucune ligne de votre code ne tourne sur DZBuild.

## Ce que propose la plateforme[​](#ce-que-propose-la-plateforme "Lien direct vers Ce que propose la plateforme")

| Élément                 | Ce qu'il apporte à votre application                                                                                                                                                                 |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Applications            | Vous enregistrez votre application dans la console développeur. Elle reçoit un `client_id`, un client secret et un secret de signature.                                                              |
| Parcours d'installation | Le propriétaire de la boutique approuve votre application sur un écran de consentement. Le parcours est OAuth 2.0 avec code d'autorisation et PKCE `S256`.                                           |
| Jetons d'installation   | Chaque boutique qui installe votre application reçoit son propre jeton bearer, limité aux scopes que le propriétaire a acceptés.                                                                     |
| API REST                | `https://api.dzbuild.app/v1` couvre la boutique, les produits, les commandes, la livraison, les clients, les landing pages, les codes promo, les pixels, l'expédition, les statistiques et WhatsApp. |
| Webhooks                | DZBuild envoie les événements de commande et `app.uninstalled` à votre adresse, signés avec `X-DZ-Signature`.                                                                                        |
| API WhatsApp            | Votre application envoie aux acheteurs les modèles de commande approuvés de la plateforme. Chaque message est payé sur le solde WhatsApp de la boutique.                                             |
| Lien d'ouverture        | Le bouton Ouvrir du tableau de bord marchand mène à votre application avec un jeton signé dans `dz_launch`.                                                                                          |
| Console développeur     | `https://dzbuild.com/dashboard/developer` sert à enregistrer vos applications, renouveler leurs secrets, les tester sur votre boutique et les envoyer en vérification.                               |

## À qui s'adresse cette documentation[​](#à-qui-sadresse-cette-documentation "Lien direct vers À qui s'adresse cette documentation")

Ces pages s'adressent aux développeurs qui créent des outils que les marchands DZBuild installent depuis leur tableau de bord. Tout compte DZBuild rattaché à une boutique peut ouvrir la console développeur. Tant qu'une application est en brouillon ou en vérification, elle ne s'installe que sur les boutiques dont le compte développeur est propriétaire. Une fois approuvée par DZBuild, tout propriétaire de boutique peut l'installer, quel que soit son plan, sauf si vous fixez un plan minimum.

La documentation marchand se trouve sur [dzbuild.com/docs](https://dzbuild.com/fr/docs/intro). Elle présente le tableau de bord du point de vue du marchand.

## Pour continuer[​](#pour-continuer "Lien direct vers Pour continuer")

* [Premiers pas](https://dzbuild.dev/fr/fr/getting-started.md) : enregistrez une application, installez-la sur votre boutique et faites votre premier appel à l'API.
* [Concepts clés](https://dzbuild.dev/fr/fr/concepts.md) : applications, installations, boutiques, plans, mode test, limite par installation et jetons d'installation.
* [OAuth](https://dzbuild.dev/fr/fr/oauth.md) : chaque paramètre d'autorisation et d'échange de jeton, et chaque code d'erreur.
* [Scopes](https://dzbuild.dev/fr/fr/scopes.md) : ce que permet chaque scope.
* [Webhooks](https://dzbuild.dev/fr/fr/webhooks.md) : événements et vérification de la signature.
* [API WhatsApp](https://dzbuild.dev/fr/fr/whatsapp.md) : envoi des modèles de commande.
* [Limites de requêtes](https://dzbuild.dev/fr/fr/rate-limits.md) : quotas de requêtes et nouvelles tentatives.
* [Référence de l'API](https://dzbuild.dev/fr/fr/api-reference.md) : tous les endpoints `/v1` et la description OpenAPI.
* [Règles de vérification](https://dzbuild.dev/fr/fr/review-guidelines.md) et [Sécurité](https://dzbuild.dev/fr/fr/security.md) : ce que DZBuild contrôle avant d'approuver une application.
* [Journal des modifications](https://dzbuild.dev/fr/fr/changelog.md) : les changements datés de la plateforme.