Développeurs
L'API publique de Stayo
L'API REST publique de Stayo vous permet de créer vos propres intégrations, applications et rapports sur les réservations, clients, chambres et tarifs. Authentification par clé API.
Que pouvez-vous construire ?
Intégrations sur mesure
Connectez Stayo à vos systèmes existants — CRM, marketing automation, ERP ou vos propres outils.
Applications sur mesure
Créez vos propres interfaces pour la réception, le ménage ou la direction au-dessus des mêmes données que Stayo utilise.
Rapports & BI
Récupérez réservations, occupation et revenus dans Power BI, Looker Studio, Excel ou votre propre entrepôt de données.
Automatisation
Déclenchez des workflows dans Make, Zapier ou n8n à partir de nouvelles réservations, arrivées ou paiements.
Authentification
Tous les appels sont authentifiés avec une clé API que vous créez sous Paramètres → Développeurs dans Stayo. Envoyez la clé comme token Bearer dans l'en-tête Authorization.
- • Clés séparées pour test et production (sk_test_… / sk_live_…).
- • La clé n'est affichée qu'une seule fois — conservez-la en sécurité.
- • Toujours envoyée en HTTPS. Jamais dans le code client ni dans l'URL.
- • Peut être renouvelée ou révoquée à tout moment.
curl https://api.stayo.se/public/v1/bookings \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx" \
-H "Accept: application/json"Endpoints (sélection)
API REST avec JSON. La spécification OpenAPI complète est fournie aux intégrateurs actifs.
| Méthode | Chemin | Description |
|---|---|---|
| GET | /bookings | Lister les réservations avec filtres par date, statut et canal. |
| POST | /bookings | Créer une nouvelle réservation. |
| GET | /bookings/{id} | Récupérer une réservation. |
| PATCH | /bookings/{id} | Mettre à jour statut, dates ou informations client. |
| GET | /guests | Rechercher et lister les clients. |
| GET | /rooms | Lister chambres, types de chambres et disponibilités. |
| GET | /rates | Récupérer tarifs et règles tarifaires. |
| GET | /invoices | Lister factures et reçus. |
| POST | /webhooks | Enregistrer des webhooks pour les événements en temps réel. |
Exemple de réponse
{
"data": [
{
"id": "bk_01HXYZ...",
"status": "confirmed",
"channel": "booking.com",
"arrival": "2026-08-12",
"departure": "2026-08-15",
"guest": { "name": "Anna Andersson", "email": "anna@example.com" },
"room": { "id": "rm_12", "type": "Dubbelrum" },
"total": { "amount": 4200, "currency": "SEK" }
}
],
"meta": { "page": 1, "per_page": 50, "total": 128 }
}Limites de débit
60 appels par minute et par clé API par défaut. L'état actuel se trouve dans les en-têtes de réponse X-RateLimit-Remaining et X-RateLimit-Reset. Besoin de plus ? Contactez-nous.
Versionnage
La version est indiquée dans l'URL (/public/v1/). Des changements non rupturants peuvent être ajoutés dans une même version. Les changements rupturants n'arrivent que dans de nouvelles versions avec au moins 6 mois de chevauchement.
Webhooks
Abonnez-vous à des événements comme booking.created, booking.updated et payment.succeeded. Tous les webhooks sont signés avec HMAC-SHA256.
Commencer avec l'API
L'API est disponible pour les clients Stayo sur le forfait Growth et au-delà. Contactez-nous et nous activerons l'accès, enverrons la spécification OpenAPI et vous aiderons à démarrer.