Entwickler

Die öffentliche API von Stayo

Die öffentliche REST-API von Stayo ermöglicht eigene Integrationen, Apps und Berichte auf Buchungen, Gäste, Zimmer und Preise. Authentifizierung mit API-Schlüssel.

Base URLhttps://api.stayo.se/public/v1/

Was können Sie bauen?

Eigene Integrationen

Verbinden Sie Stayo mit Ihren bestehenden Systemen – CRM, Marketing-Automation, ERP oder eigenen Werkzeugen.

Eigene Apps

Bauen Sie eigene Oberflächen für Rezeption, Reinigung oder Management auf denselben Daten, die Stayo verwendet.

Berichte & BI

Ziehen Sie Buchungen, Auslastung und Umsätze in Power BI, Looker Studio, Excel oder Ihr eigenes Data Warehouse.

Automatisierung

Starten Sie Workflows in Make, Zapier oder n8n bei neuen Buchungen, Anreisen oder Zahlungen.

Authentifizierung

Alle Aufrufe werden mit einem API-Schlüssel authentifiziert, den Sie unter Einstellungen → Entwickler in Stayo erstellen. Senden Sie den Schlüssel als Bearer-Token im Authorization-Header mit.

• Getrennte Schlüssel für Test und Produktion (sk_test_… / sk_live_…).
• Der Schlüssel wird nur einmal angezeigt – bewahren Sie ihn sicher auf.
• Immer über HTTPS gesendet. Niemals im Client-Code oder in der URL.
• Kann jederzeit erneuert oder widerrufen werden.

curl https://api.stayo.se/public/v1/bookings \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx" \
  -H "Accept: application/json"

Endpunkte (Auswahl)

REST-API mit JSON. Die vollständige OpenAPI-Spezifikation wird an aktive Integratoren bereitgestellt.

Methode	Pfad	Beschreibung
GET	/bookings	Buchungen mit Filtern nach Datum, Status und Kanal auflisten.
POST	/bookings	Eine neue Buchung erstellen.
GET	/bookings/{id}	Eine Buchung abrufen.
PATCH	/bookings/{id}	Status, Daten oder Gästeinformationen aktualisieren.
GET	/guests	Gäste suchen und auflisten.
GET	/rooms	Zimmer, Zimmertypen und Verfügbarkeit auflisten.
GET	/rates	Preise und Preisregeln abrufen.
GET	/invoices	Rechnungen und Belege auflisten.
POST	/webhooks	Webhooks für Echtzeit-Events registrieren.

Beispielantwort

{
  "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 }
}

Rate-Limits

Standardmäßig 60 Aufrufe pro Minute und API-Schlüssel. Der aktuelle Status steht in den Response-Headern X-RateLimit-Remaining und X-RateLimit-Reset. Sie brauchen mehr? Kontaktieren Sie uns.

Versionierung

Die Version steht in der URL (/public/v1/). Nicht-breaking Änderungen können innerhalb derselben Version hinzugefügt werden. Breaking Changes kommen nur in neuen Versionen mit mindestens 6 Monaten Überlappung.

Webhooks

Abonnieren Sie Events wie booking.created, booking.updated und payment.succeeded. Alle Webhooks sind mit HMAC-SHA256 signiert.

Mit der API starten

Die API ist für Stayo-Kunden ab dem Growth-Paket verfügbar. Kontaktieren Sie uns – wir aktivieren den Zugang, senden die OpenAPI-Spezifikation und helfen Ihnen beim Einstieg.

Kontaktieren Sie uns hej@stayo.se