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.
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.
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.
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.