Udviklere

Stayos offentlige API

Stayos offentlige REST-API lader jer bygge egne integrationer, apps og rapporter mod bookinger, gæster, værelser og priser. Autentificering via API-nøgle.

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

Hvad kan I bygge?

Egne integrationer

Forbind Stayo med jeres eksisterende systemer — CRM, marketing automation, økonomisystemer eller egne værktøjer.

Skræddersyede apps

Byg jeres egne grænseflader til reception, rengøring eller ledelse oven på samme data, som Stayo bruger.

Rapporter & BI

Hent bookinger, belægning og indtægter til Power BI, Looker Studio, Excel eller jeres eget datalager.

Automatisering

Udløs arbejdsgange i Make, Zapier eller n8n baseret på nye bookinger, indtjekninger eller betalinger.

Autentificering

Alle kald autentificeres med en API-nøgle, som I opretter under Indstillinger → Udviklere i Stayo. Send nøglen som Bearer-token i Authorization-headeren.

• Separate nøgler til test og produktion (sk_test_… / sk_live_…).
• Nøglen vises kun én gang — opbevar den sikkert.
• Sendes altid over HTTPS. Aldrig i klientkode eller URL.
• Kan roteres eller tilbagekaldes når som helst.

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

Endpoints (udvalg)

REST-baseret API med JSON. Fuld OpenAPI-specifikation gives til aktive integratorer.

Metode	Sti	Beskrivelse
GET	/bookings	List bookinger med filter på dato, status og kanal.
POST	/bookings	Opret en ny booking.
GET	/bookings/{id}	Hent en enkelt booking.
PATCH	/bookings/{id}	Opdater status, datoer eller gæsteoplysninger.
GET	/guests	Søg og list gæster.
GET	/rooms	List værelser, værelsestyper og tilgængelighed.
GET	/rates	Hent priser og prisregler.
GET	/invoices	List fakturaer og kvitteringer.
POST	/webhooks	Registrer webhooks til realtidshændelser.

Eksempelsvar

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

60 kald per minut per API-nøgle som standard. Aktuel status findes i svarheaderne X-RateLimit-Remaining og X-RateLimit-Reset. Har I brug for mere, så kontakt os.

Versionering

Versionen angives i URL'en (/public/v1/). Ikke-brydende ændringer kan tilkomme inden for samme version. Brydende ændringer sker kun i nye versioner med mindst 6 måneders overlap.

Webhooks

Abonnér på hændelser som booking.created, booking.updated og payment.succeeded. Alle webhooks signeres med HMAC-SHA256.

Kom i gang med API'et

API'et er tilgængeligt for Stayo-kunder på Growth-planen og opefter. Kontakt os, så aktiverer vi adgang, sender OpenAPI-specifikationen og hjælper jer i gang.

Kontakt os hej@stayo.se