Aller au contenu principal

L'API DZBuild est live — Construisez des intégrations custom pour votre boutique

· 3 minutes de lecture
DZBuild Team
DZBuild Team
We build the platform

Aujourd'hui on lance DZBuild API v1 pour le grand public. Clé, doc, exemples, tout vous attend.

Ce que vous pouvez construire​

  • Vitrines headless — boutique React/Vue/Next.js parlant entièrement via API.
  • Automatisation back-office — sync commandes vers CRM, import produits en bulk, confirm en bulk.
  • Apps mobiles — iOS / Android avec gestion commandes + notifs.
  • Intégrations partenaires — Zapier, n8n, Make, n'importe quelle plateforme d'automatisation.
  • Plateformes revendeurs — agences gérant des dizaines de boutiques clients depuis un back-office.

Démarrage rapide​

URL de base​

https://api.dzbuild.app/v1

Authentification​

Authorization: Bearer dzpk_live_<key_id>.<secret>

Créer votre première clé​

Dashboard → Developer → API Keys → « + Créer clé plateforme » → choisissez les scopes → sauvez le secret.

Ce qu'il y a en v1​

Ressources principales​

  • /v1/store — données boutique
  • /v1/products — CRUD produits complet
  • /v1/orders — créer, lire, transitions, annulation
  • /v1/customers — lecture clients + leurs commandes
  • /v1/landing-pages — CRUD landing pages
  • /v1/keys, /v1/usage, /v1/quotas — administration

Endpoints clé publique​

  • /v1/signups — tracking d'inscriptions à fort volume avec HMAC
  • /v1/events — events génériques

Webhooks​

  • 10 events : order.*, payment.received, signup.counted, event.recorded, product.stock_low, webhook.test
  • Signatures HMAC-SHA256, queue de retry, DLQ.

Exemple : créer un produit​

curl -X POST 'https://api.dzbuild.app/v1/products' \
  -H "Authorization: Bearer $DZ_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ "name":"T-shirt", "price":1500, "status":"active" }'

Exemple : lister les commandes​

curl 'https://api.dzbuild.app/v1/orders?status=pending&limit=20' \
  -H "Authorization: Bearer $DZ_KEY"

Architecture​

Design edge-first​

Les requêtes arrivent sur Cloudflare Workers dans 300+ PoPs :

  • Auth + HMAC en périphérie (l'origine ne voit pas les requêtes non-authentifiées).
  • Limite par clé.
  • Cache lecture 30 s.
  • Les écritures à fort volume passent par files et retournent 202 immédiatement.

Enveloppe de réponse​

{ "data": ..., "meta": { "request_id": "...", "api_version": "v1" } }

Limites de taux​

PlanReq/minReq/mois
Free3010K
Pro300500K
Illimité API12005M
Enterprise6000+illimité

Idempotence​

Chaque POST/PATCH/DELETE nécessite Idempotency-Key. Rejouer avec la même clé sous 24 h = même réponse.

Pagination​

Par curseur — cursor + next_cursor + has_more.

SDKs et bibliothèques​

  • Référence TypeScript / Node.js (à venir par DZBuild)
  • Lib Python (community)
  • Lib PHP (community)

Pour commencer​

Documentation API complète

Exemples concrets​

Sync produits depuis CSV​

for row in csv.DictReader(f):
    requests.post('https://api.dzbuild.app/v1/products', json=row, headers={...})

Handler webhook​

app.post('/webhook', verifySignature, (req, res) => {
  if (req.body.event === 'order.created') notifyCRM(req.body.data);
  res.status(200).end();
});

Support​

Tarification​

L'API est incluse dans les plans Pro et au-delà. En période pilote (maintenant), la consommation n'est pas facturée. La tarification finale sera annoncée à la sortie du pilote.

La suite​

  • v1.1 : tarif livraison via GET /v1/store, combinaisons produit, upload images R2 presigned, refunds.
  • v1.2 : SDK officiels Node et Python.

Construisez maintenant​

Créez votre clé depuis le dashboard, lisez la doc, commencez.