# API et développeurs

> Donnez à des systèmes externes un accès en lecture seule à vos commandes et réservations — règles d'usage, démarrage rapide, et le sens inverse pour les boutiques sur mesure.

- Source: https://support.unifunl.io/fr/help/account-billing/api-and-developers
- Category: Compte et facturation (`account-billing`)
- Language: fr
- Updated: 2026-08-20

---

**Paramètres**, puis **API keys**. L'API publique donne à des systèmes externes un accès en lecture seule à vos commandes et à vos réservations.

![La page API keys, avec le guide de démarrage rapide directement sur la page.](https://support.unifunl.io/help/screenshots/42-api-keys.jpg)

## Règles d'usage

| Règle | Détail |
| --- | --- |
| Lecture seule | Les clés peuvent lire les commandes et les allocations de ressources, et rien d'autre. Aucune écriture n'est possible. |
| Limite de débit | 120 requêtes par minute et par clé. |
| Authentification | La clé se transmet dans l'en-tête `x-api-key`. |
| Côté serveur uniquement | Appelez l'API depuis votre serveur, jamais depuis du code exécuté dans le navigateur — votre clé serait exposée. |

## Démarrage rapide

Lister les commandes. Filtres disponibles : `page`, `take`, `search`, `status`, `source`, `dateFrom` et `dateTo`, `customerEmail` et `customerPhone`.

```
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.unifunl.io/api/v1/public/orders?page=1&take=20"
```

Lister les réservations. Filtres disponibles : `page`, `take`, `status`, `resourceTypeId`, ainsi que des plages de dates de création, de début et de fin.

```
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.unifunl.io/api/v1/public/allocations?page=1&take=20"
```

## Les cas d'usage courants

- **Zapier ou Make** — déclencher un workflow à chaque nouvelle commande.
- **ERP ou comptabilité** — rapatrier les commandes dans votre système de gestion.
- **Tableaux de bord** — alimenter vos propres rapports avec vos données de vente.

> **Dans l'autre sens** — si vous avez une boutique sur mesure et que vous voulez qu'Unifunl y lise *vos* produits et commandes, c'est l'**Unifunl Commerce API** qu'il faut implémenter, puis connecter via **Intégrations**, **Custom store**, avec une URL de base et un jeton. Voir [Intégrations boutique](https://support.unifunl.io/fr/help/channels-integrations/store-integrations).

## FAQ et dépannage

### Qui peut créer une clé API ?

Considérez cette page comme réservée au propriétaire. Les clés étant révocables individuellement, émettez-en une par intégration plutôt que d'en partager une seule.

### Je suis limité en débit

La limite est de 120 requêtes par minute et par clé. Groupez vos requêtes avec `page` et `take` plutôt que de récupérer les enregistrements un par un.

### L'API peut-elle créer ou modifier des commandes ?

Non. L'API publique est en lecture seule par conception. Pour qu'Unifunl écrive dans votre boutique, utilisez plutôt une intégration boutique.

## Et ensuite ?

Vérifiez qui, dans votre équipe, peut accéder à quoi.

[Équipe et rôles](https://support.unifunl.io/fr/help/account-billing/team-and-roles)

## Related articles

- [Sécurité et données](https://support.unifunl.io/fr/help/account-billing/security-and-data.md): Ce qu'il advient de vos données et de celles de vos clients, les leviers que vous gardez, et comment auditer ce qui a été envoyé.
- [Intégrations boutique](https://support.unifunl.io/fr/help/channels-integrations/store-integrations.md): Le catalogue complet des plateformes e-commerce supportées, ce que chacune synchronise, et ce qu'il faut pour la connecter.
- [Crédits et facturation](https://support.unifunl.io/fr/help/account-billing/credits-and-billing.md): Comment les crédits sont consommés et rechargés, ce que dit la page Usage, ce qui se passe à zéro, et comment se comparent les plans.