Kehittäjät

Stayon julkinen API

Stayon julkinen REST-API antaa teidän rakentaa omia integraatioita, sovelluksia ja raportteja varauksiin, vieraisiin, huoneisiin ja hintoihin. Tunnistautuminen API-avaimella.

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

Mitä voitte rakentaa?

Omat integraatiot

Yhdistä Stayo olemassa oleviin järjestelmiinne — CRM, markkinoinnin automaatio, talousjärjestelmät tai omat työkalut.

Räätälöidyt sovellukset

Rakentakaa omat käyttöliittymät vastaanotolle, siivoukselle tai johdolle saman datan päälle, jota Stayo käyttää.

Raportit & BI

Hakekaa varaukset, täyttöaste ja tulot Power BI:hin, Looker Studioon, Exceliin tai omaan tietovarastoonne.

Automaatio

Käynnistäkää työnkulkuja Makessa, Zapierissa tai n8n:ssä uusien varausten, sisäänkirjautumisten tai maksujen perusteella.

Tunnistautuminen

Kaikki kutsut tunnistetaan API-avaimella, jonka luote kohdassa Asetukset → Kehittäjät Stayossa. Lähetä avain Bearer-tokenina Authorization-otsikossa.

• Erilliset avaimet testille ja tuotannolle (sk_test_… / sk_live_…).
• Avain näytetään vain kerran — säilytä se turvallisesti.
• Lähetetään aina HTTPS:n yli. Ei koskaan asiakaskoodissa tai URL:ssa.
• Voidaan kierrättää tai peruuttaa milloin tahansa.

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

Endpointit (valikoima)

REST-pohjainen API JSON:lla. Täydellinen OpenAPI-spesifikaatio annetaan aktiivisille integraattoreille.

Metodi	Polku	Kuvaus
GET	/bookings	Listaa varaukset päivämäärän, tilan ja kanavan suodattimilla.
POST	/bookings	Luo uusi varaus.
GET	/bookings/{id}	Hae yksittäinen varaus.
PATCH	/bookings/{id}	Päivitä tila, päivämäärät tai vierastiedot.
GET	/guests	Hae ja listaa vieraita.
GET	/rooms	Listaa huoneet, huonetyypit ja saatavuus.
GET	/rates	Hae hinnat ja hintasäännöt.
GET	/invoices	Listaa laskut ja kuitit.
POST	/webhooks	Rekisteröi webhookit reaaliaikaisiin tapahtumiin.

Esimerkkivastaus

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

60 kutsua minuutissa per API-avain oletuksena. Nykyinen tila näkyy vastausotsikoissa X-RateLimit-Remaining ja X-RateLimit-Reset. Tarvitsetteko lisää, ottakaa yhteyttä.

Versiointi

Versio määritetään URL:ssa (/public/v1/). Ei-rikkovia muutoksia voidaan lisätä saman version sisällä. Rikkovat muutokset tapahtuvat vain uusissa versioissa vähintään 6 kuukauden päällekkäisyydellä.

Webhookit

Tilaa tapahtumia kuten booking.created, booking.updated ja payment.succeeded. Kaikki webhookit allekirjoitetaan HMAC-SHA256:lla.

Aloita API:n käyttö

API on saatavilla Stayo-asiakkaille Growth-paketista ylöspäin. Ottakaa yhteyttä, niin aktivoimme pääsyn, lähetämme OpenAPI-spesifikaation ja autamme alkuun.

Ota yhteyttä hej@stayo.se