Rajapinta ja kalenterisynkronointi

Jos hallitset tilojesi kalenteria omassa järjestelmässäsi, Saunailta ei vaadi kaksinkertaista kirjaamista. Käytössä on kaksi tapaa – valitse se, joka sopii järjestelmääsi.

1. Kalenterisynkronointi (iCal)

Ei vaadi ohjelmointia. Lähes kaikki varaus- ja kalenterijärjestelmät tukevat tätä.

Saunailta → oma kalenterisi

Jokaisella tilalla on oma kalenteriosoite, jonka löydät ilmoituksen kohdasta Näkyvyys ja kalenteri. Lisää osoite omaan järjestelmääsi, niin palvelun kautta tulleet varaukset näkyvät siellä automaattisesti.

https://saunailta.net/api/ical/<salainen-tunniste>.ics

Syötteessä on vain varatut aikavälit. Asiakkaiden nimiä, yhteystietoja tai hintoja ei koskaan jaeta kalenterissa. Osoite on salainen – älä julkaise sitä.

Oma kalenterisi → Saunailta

Liitä oman järjestelmäsi julkinen iCal-osoite ilmoituksen kohtaan Tuo kalenteri. Haemme sen säännöllisesti ja merkitsemme siellä varatut ajat suljetuiksi, jolloin samaa tilaa ei voi varata kahdesti.

Tuonti tapahtuu tunnin välein. Kiireellisen muutoksen voi tehdä myös suoraan ilmoituksen kalenterista.

2. Kumppanirajapinta (REST)

Omaan järjestelmään liitettävä rajapinta. Pyydä rajapinta-avain osoitteesta asiakaspalvelu@saunailta.net. Avain on tunnuskohtainen ja näkee vain omat tilasi.

Tunnistautuminen

Authorization: Bearer <rajapinta-avain>
Content-Type: application/json

Kaikki osoitteet käyttävät HTTPS:ää. Summat ovat sentteinä ja ajat ISO 8601 -muodossa.

GET/api/kumppani/kohteet

Omat tilat, niiden paketit ja lisäpalvelut sekä kunkin kalenteriosoite.

curl -H "Authorization: Bearer AVAIN" \
  https://saunailta.net/api/kumppani/kohteet

GET/api/kumppani/varaukset?alkaen=2026-10-01&tila=PYYNTO

Varaukset aikajärjestyksessä. Mukana tila, ajankohta, henkilömäärä, kokonaishinta, välityspalkkio ja tilitettävä osuus sekä varaajan yhteystiedot varauksen hoitamista varten.

curl -H "Authorization: Bearer AVAIN" \
  "https://saunailta.net/api/kumppani/varaukset?alkaen=2026-10-01"

POST/api/kumppani/varaukset

Hyväksy tai hylkää varauspyyntö. Hyväksyntä lukitsee ajankohdan asiakkaalle maksun ajaksi ja lähettää maksulinkin.

{ "viite": "HI-ABC-DEF", "toiminto": "hyvaksy" }
{ "viite": "HI-ABC-DEF", "toiminto": "hylkaa", "syy": "Tila on varattu" }

GET/api/kumppani/suljetut?kohdeId=1

Tilan suljetut ajankohdat.

POST/api/kumppani/suljetut

Sulje ajankohta omasta järjestelmästä, esimerkiksi kun tila varataan muuta kautta.

{ "kohdeId": 1,
  "alkaa": "2026-10-04T16:00:00+03:00",
  "paattyy": "2026-10-04T23:00:00+03:00",
  "syy": "Oma varaus" }

DELETE/api/kumppani/suljetut?id=12

Avaa aiemmin suljettu ajankohta uudelleen varattavaksi.

Hyvä tietää

Rajapinta ei koskaan vahvista varausta ohi maksun: hyväksyntä siirtää varauksen tilaan MAKSUA_ODOTTAA, ja se vahvistuu vasta varmennetusta maksusta.
Ajan sulkeminen ei onnistu, jos ajankohdalla on jo vahvistettu varaus. Tällöin saat vastauksen 409.
Yksi varaus tarkoittaa aina yhtä kokonaisuutta oman porukan käyttöön. Henkilökohtaisia saunavuoroja tai hotellihuoneita ei myydä tämän kautta.
Säilytä avain palvelimella. Jos avain vuotaa, ilmoita heti – suljemme sen.

Haluatko rajapinta-avaimen?

Kerro viestissä yrityksen nimi, tilojen määrä ja mitä järjestelmää käytätte. Vastaamme arkisin.

Pyydä avain Tilan tarjoajille