Utviklere

Stayos offentlige API

Stayos offentlige REST-API lar dere bygge egne integrasjoner, apper og rapporter mot bookinger, gjester, rom og priser. Autentisering via API-nøkkel.

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

Hva kan dere bygge?

Egne integrasjoner

Koble Stayo mot deres eksisterende systemer — CRM, marketing automation, forretningssystemer eller egne verktøy.

Skreddersydde apper

Bygg egne grensesnitt for resepsjon, renhold eller ledelse oppå samme data som Stayo bruker.

Rapporter & BI

Hent bookinger, belagg og inntekter til Power BI, Looker Studio, Excel eller deres eget datalager.

Automatisering

Utløs arbeidsflyter i Make, Zapier eller n8n basert på nye bookinger, innsjekkinger eller betalinger.

Autentisering

Alle kall autentiseres med en API-nøkkel som dere oppretter under Innstillinger → Utviklere i Stayo. Send nøkkelen som Bearer-token i Authorization-headeren.

• Separate nøkler for test og produksjon (sk_test_… / sk_live_…).
• Nøkkelen vises bare én gang — oppbevar den trygt.
• Sendes alltid over HTTPS. Aldri i klientkode eller URL.
• Kan roteres eller tilbakekalles når som helst.

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

Endepunkter (utvalg)

REST-basert API med JSON. Fullstendig OpenAPI-spesifikasjon gis til aktive integratører.

Metode	Sti	Beskrivelse
GET	/bookings	List bookinger med filter på dato, status og kanal.
POST	/bookings	Opprett en ny booking.
GET	/bookings/{id}	Hent en enkelt booking.
PATCH	/bookings/{id}	Oppdater status, datoer eller gjesteopplysninger.
GET	/guests	Søk og list gjester.
GET	/rooms	List rom, romtyper og tilgjengelighet.
GET	/rates	Hent priser og prisregler.
GET	/invoices	List fakturaer og kvitteringer.
POST	/webhooks	Registrer webhooks for sanntidshendelser.

Eksempelrespons

{
  "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 kall per minutt per API-nøkkel som standard. Gjeldende status finnes i svarheaderne X-RateLimit-Remaining og X-RateLimit-Reset. Trenger dere mer, ta kontakt.

Versjonering

Versjonen angis i URL-en (/public/v1/). Ikke-brytende endringer kan tilkomme innen samme versjon. Brytende endringer skjer kun i nye versjoner med minst 6 måneders overlapp.

Webhooks

Abonner på hendelser som booking.created, booking.updated og payment.succeeded. Alle webhooks signeres med HMAC-SHA256.

Kom i gang med API-et

API-et er tilgjengelig for Stayo-kunder på Growth-plan og oppover. Ta kontakt så aktiverer vi tilgang, sender OpenAPI-spesifikasjonen og hjelper dere i gang.

Kontakt oss hej@stayo.se