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

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

## Ce que vous pouvez construire[​](#ce-que-vous-pouvez-construire "Lien direct vers 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[​](#démarrage-rapide "Lien direct vers Démarrage rapide")

### URL de base[​](#url-de-base "Lien direct vers URL de base")

```
https://api.dzbuild.app/v1
```

### Authentification[​](#authentification "Lien direct vers Authentification")

```
Authorization: Bearer dzpk_live_<key_id>.<secret>
```

### Créer votre première clé[​](#créer-votre-première-clé "Lien direct vers Créer votre première clé")

Dashboard → **Paramètres → API** ([`/dashboard/api`](https://dzbuild.com/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[​](#ce-quil-y-a-en-v1 "Lien direct vers Ce qu'il y a en v1")

### Ressources principales[​](#ressources-principales "Lien direct vers 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[​](#endpoints-clé-publique "Lien direct vers Endpoints clé publique")

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

### Webhooks[​](#webhooks "Lien direct vers 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[​](#exemple--créer-un-produit "Lien direct vers 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[​](#exemple--lister-les-commandes "Lien direct vers Exemple : lister les commandes")

```
curl 'https://api.dzbuild.app/v1/orders?status=pending&limit=20' \

  -H "Authorization: Bearer $DZ_KEY"
```

## Comportement des requêtes[​](#comportement-des-requêtes "Lien direct vers 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[​](#enveloppe-de-réponse "Lien direct vers Enveloppe de réponse")

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

## Limites de taux[​](#limites-de-taux "Lien direct vers Limites de taux")

| Plan         | Req/min | Req/mois |
| ------------ | ------- | -------- |
| Free         | 30      | 10K      |
| Pro          | 300     | 500K     |
| Illimité API | 1200    | 5M       |
| Enterprise   | 6000+   | illimité |

## Idempotence[​](#idempotence "Lien direct vers Idempotence")

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

## Pagination[​](#pagination "Lien direct vers Pagination")

Par curseur — `cursor` + `next_cursor` + `has_more`.

## SDKs et bibliothèques[​](#sdks-et-bibliothèques "Lien direct vers SDKs et bibliothèques")

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

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

[Documentation API complète](https://dzbuild.com/fr/fr/api-docs/intro.md)

## Exemples concrets[​](#exemples-concrets "Lien direct vers Exemples concrets")

### Sync produits depuis CSV[​](#sync-produits-depuis-csv "Lien direct vers Sync produits depuis CSV")

```
for row in csv.DictReader(f):

    requests.post('https://api.dzbuild.app/v1/products', json=row, headers={...})
```

### Handler webhook[​](#handler-webhook "Lien direct vers Handler webhook")

```
app.post('/webhook', verifySignature, (req, res) => {

  if (req.body.event === 'order.created') notifyCRM(req.body.data);

  res.status(200).end();

});
```

## Support[​](#support "Lien direct vers Support")

* Doc : dzbuild.com/api-docs
* Email : <support@dzbuild.com>
* Telegram : t.me/dzbuild

## Tarification[​](#tarification "Lien direct vers 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[​](#la-suite "Lien direct vers 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[​](#construisez-maintenant "Lien direct vers Construisez maintenant")

Créez votre clé depuis le dashboard, lisez la [doc](https://dzbuild.com/fr/fr/api-docs/intro.md), commencez.