Aller au contenu principal

Créez des applications pour les boutiques DZBuild

Créez un outil que tout marchand peut installer sur sa boutique DZBuild, ou un outil privé qui automatise la vôtre. Partez d’un exemple qui fonctionne, d’un prompt prêt pour votre assistant IA, ou de l’API directement.

Vous hébergez l’application. Le marchand choisit les données auxquelles elle peut accéder.

Donnez une seule ligne à votre agent de code

Read https://dzbuild.dev/llms.txt and https://dzbuild.dev/skills/dzbuild-apps/SKILL.md. Then help me build a DZBuild app.

D’une requête API à l’export du catalogue.

cloudflare-catalogExemple d’application

Un catalogue prêt à exporter

L’exemple de catalogue affiche les produits d’une boutique et permet au marchand de les télécharger en CSV.

  1. Le marchand connecte sa boutiqueOAuth
  2. Votre application lit les produitsproducts:read
  3. Le marchand télécharge le catalogueCSV

Deux façons de construire sur DZBuild

Pour les développeurs

Créez une app que tout vendeur peut installer

  • Installation OAuth, un jeton par boutique, webhooks signés
  • Commandes, produits, livraison, clients et WhatsApp dans une seule API REST
  • Listée dans le tableau de bord après la revue de DZBuild

Pour les vendeurs

Automatisez votre boutique avec l’IA

  • Tous les plans : un assistant IA crée une app privée que seules vos boutiques peuvent installer
  • Ventes du jour sur Telegram, commandes dans Google Sheets, alertes de stock bas, prix modifiés en masse
  • Plan Enterprise : gérez la boutique en discutant avec Claude ou ChatGPT

Comment fonctionne une application

  1. Enregistrez l'application

    Créez-la dans la console développeur. Vous obtenez un client_id, un secret client affiché une seule fois et un secret de signature pour les webhooks et les liens d'ouverture.

    Premiers pas
  2. Un marchand l'installe

    Envoyez le marchand vers l'URL d'autorisation avec un défi PKCE. Il approuve sur un écran de consentement DZBuild, et votre serveur échange le code contre un jeton d'installation par boutique.

    Le flux OAuth
  3. Appelez l'API

    Envoyez le jeton à api.dzbuild.app/v1. Interrogez GET /v1/orders?since= pour les nouvelles commandes, ou recevez des événements de commande signés sur une URL de webhook d'un domaine qui vous appartient (DZBuild refuse les adresses workers.dev). Testez sur votre propre boutique, puis soumettez l'application à la vérification.

    Webhooks
Voir un exemple d’autorisation et de réponse avec jeton

DZBuild est la plateforme e-commerce des marchands algériens. Une application DZBuild est un service web que vous hébergez, sur votre propre compte Cloudflare ou votre propre serveur. Un marchand l'installe sur sa boutique, et votre application lit et modifie les commandes, les produits, la livraison, les clients et les messages WhatsApp de cette boutique via l'API REST.

Le marchand approuve sur DZBuild

Installer orders-bot sur votre boutique

orders-bot demande l'accès à votre boutique. Une fois approuvé, il pourra uniquement faire ce qui suit.

Ce que cette application pourra faire

Consulter les commandes (lecture seule ; aucune création ni modification) orders:read

RefuserApprouver et installer

Vous pouvez retirer l'application à tout moment depuis la page Extensions.

Votre serveur échange le code contre le jeton d'installation

POST https://dzbuild.com/oauth/apps/token

200 OK
{
  "access_token": "dzpk_live_0a1b2c3d4e5f67.9f8e...",
  "token_type": "Bearer",
  "scope": "orders:read",
  "store_id": 141,
  "install_id": 7,
  "stores": [
    {
      "store_id": 141,
      "store_name": "My test store",
      "install_id": 7,
      "access_token": "dzpk_live_0a1b2c3d4e5f67.9f8e..."
    }
  ]
}
Le flux OAuth

Bibliothèque de prompts

Collez un prompt, obtenez un outil qui marche

Chaque prompt d’app envoie d’abord l’assistant vers cette documentation : Claude, ChatGPT, Codex ou Cursor construit sur la vraie API. Les 18 prompts

Envoyer chaque nouvelle commande dans un groupe Telegram

Un message Telegram par commande, jamais en double, depuis une app qui lit la liste des commandes chaque minute.

orders:read

Read https://dzbuild.dev/llms.txt and https://dzbuild.dev/skills/dzbuild-apps/SKILL.md. Build a DZBuild app that posts every new order to a Telegram group. Start from the cloudflare-orders preset of https://github.com/DZBuild-com/dzbuild-app-starter. New orders come from polling GET /v1/orders?since= once a minute, because the app runs on workers.dev and cannot receive webhooks yet. One Telegram message per order, never twice; the bot token is a Worker secret.

Mon bilan de ventes sur Telegram chaque soir

À 21 h, heure d’Alger : commandes reçues, confirmées, expédiées, livrées, annulées et retournées du jour.

orders:readanalytics:read

Read https://dzbuild.dev/llms.txt and https://dzbuild.dev/skills/dzbuild-apps/SKILL.md. I sell on DZBuild and I am not a developer. Build me a private DZBuild app for my own store: it stays a draft in the developer console and installs only on stores I own. Every evening at 21:00 Algiers time (20:00 UTC, a Cron Trigger), send me one Telegram message with today's orders counted by status (pending, confirmed, processing, shipped, delivered, cancelled, returned) and the figures from GET /v1/analytics?range=today. Read the orders with GET /v1/orders?since=<today 00:00 Algiers time> and follow data.next_cursor while data.has_more is true. The Telegram bot token is a Worker secret. Start from the cloudflare-orders preset of https://github.com/DZBuild-com/dzbuild-app-starter and host it on my Cloudflare account. Ask only for the scopes orders:read and analytics:read. Tell me exactly what to paste into the developer console and which secrets go into `wrangler secret put`, one step at a time. Explain every step to me in simple French.

Voir les commandes en attente du jour par wilaya

Vos commandes en attente regroupées par wilaya, avec les numéros qui ont commandé plusieurs fois.

Montre-moi les commandes d’aujourd’hui encore en attente dans ma boutique DZBuild, regroupées par wilaya, avec le nom du client, son téléphone et le total. Dis-moi ensuite quels numéros ont commandé plus d’une fois.

Ce que votre application peut atteindre

Un scope par type de données de boutique. Le marchand voit une ligne par ressource sur l'écran de consentement et n'accorde que ce que vous demandez. Tous les scopes

  • Commandes

    Lire les commandes et leurs articles. Créer des commandes, changer leur statut, les annuler.

    orders:readorders:write
  • Livraison

    Remettre une commande au transporteur de la boutique.

    delivery:send
  • Produits

    Catalogue et catégories, avec images, variantes, offres, règles de quantité et stock.

    products:readproducts:write
  • Clients

    Les clients et les commandes de chacun.

    customers:read
  • Pages de destination

    Les pages de destination et leurs sections, et le contrôle effectué avant la publication.

    landing_pages:readlanding_pages:write
  • Expédition

    Tarifs et réglages, transporteurs liés, couverture, listes des wilayas et des communes.

    shipping:readshipping:write
  • Boutique

    Profil, design, sections de la page d'accueil et thèmes.

    store:readstore:write
  • Codes promo et pixels

    Codes de réduction et pixels de suivi.

    promos:readpromos:writepixels:readpixels:write
  • Statistiques

    Statistiques et indicateurs de la boutique.

    analytics:read
  • WhatsApp

    Modèles de commande approuvés, solde du portefeuille de la boutique, journal des messages et envoi.

    whatsapp:readwhatsapp:send

Des règles sur lesquelles construire

Un jeton par boutique
Les jetons d'installation commencent par dzpk_live_, n'ont pas de date d'expiration et sont révoqués dès que le marchand désinstalle votre application.
120 requêtes par minute
Par installation, contrôlées avant le budget partagé de la boutique. Une réponse 429 porte l'en-tête Retry-After.
Idempotency-Key sur les écritures
POST, PATCH et DELETE en ont besoin. La réponse est conservée 24 heures et rejouée quand vous réessayez.
Webhooks HMAC-SHA256
X-DZ-Signature couvre l'horodatage et le corps brut. Rejetez tout ce qui a plus de 5 minutes. Jusqu'à 5 tentatives de livraison.
Les webhooks exigent votre propre domaine
DZBuild refuse les URL de webhook sur workers.dev. Tant que l'application ne tourne pas sur un domaine qui vous appartient, interrogez GET /v1/orders?since= une fois par minute.
Tous les plans
Chaque plan peut installer une application. Fixez un plan minimum dans la console si votre application en a besoin.
Vérification avant publication
Une application en brouillon ne tourne que sur vos boutiques. DZBuild la vérifie avant que d'autres marchands puissent l'installer.

Gratuit et open source

Des outils à utiliser avec ou sans boutique

Une API de livraison, une caisse pour les magasins et une bibliothèque pour le navigateur, gratuites. Voir tous les outils

DZShip

API de livraison gratuite pour 99 transporteurs algériens. Ni inscription ni clé API : vos identifiants transporteur, utilisés à chaque appel et jamais enregistrés.

En savoir plus

DZBuild POS

Caisse gratuite pour les magasins sous Windows : lecteur de codes-barres, tickets, kridi, sauvegardes. Fonctionne hors ligne et se synchronise avec une boutique DZBuild.

En savoir plus
VisitoJS

Projet partenaire

Identification d’appareil open source pour le navigateur. MIT, environ 7,5 Ko compressé, aucune requête réseau.

En savoir plus

Enregistrez votre première application

La console développeur se trouve dans votre tableau de bord DZBuild. Tout compte qui possède une boutique peut l'ouvrir, et une application en brouillon s'installe tout de suite sur votre boutique.

La mascotte de Bunny qui saute

Partenaire DZBuild

Bunny CDN pour les fichiers autour de votre application

Images, vidéos, stockage et DNS chez Bunny, avec un essai gratuit de 14 jours sans carte bancaire.

DZBuild est partenaire de Bunny.