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
Nous construisons la plateforme

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 → Paramètres → API (/dashboard/api) — réservé au propriétaire de la boutique (plan Enterprise) ; le secret ne s'affiche qu'une seule fois, à la création : sauvegardez-le.

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, avec réessai automatique en cas d'échec de livraison.

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"

Comportement des requêtes​

L'API est servie depuis un réseau global : la latence reste basse d'où que vous appeliez.

  • Une requête sans clé valide (ou sans signature HMAC valide pour une clé publique) est rejetée en 401 avant tout traitement.
  • Limite de débit par clé ; au-delà, 429 avec retry_after.
  • Les lectures GET sûres peuvent être servies depuis le cache pendant 30 s.
  • Les endpoints à fort volume (/v1/signups, /v1/events) retournent 202 immédiatement et terminent le traitement de façon asynchrone.

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, URLs d'upload d'images presigned, refunds.
  • v1.2 : SDK officiels Node et Python.

Construisez maintenant​

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