REST API

Integroi järjestelmäsi REST API:n avulla

Saa täydellinen pääsy varaus-, vieras- ja huonetietoihin meidän REST API:n kautta. Automatisoi prosessit ja integroi mobiilikalenteri omiin järjestelmiisi.

GET /v1/public/reservations
Authorization: Bearer {access_token}

{
  "data": {
    "reservationId": 478652,
    "roomId": 28568,
    "arrival": "2025-10-14",
    "departure": "2025-10-16",
    "clientId": 362792
  },
  "meta": {
    "ruid": "7f80f1b4-a44b-4345-b383-7d0a937b4411"
  }
}
Ominaisuudet

Kattava API yrityksellesi

REST API:mme tarjoaa täyden pääsyn kaikkiin järjestelmän ominaisuuksiin, mahdollistaen mukautettujen integraatioiden ja automaatioiden luomisen.

CRUD-operaatiot

Täysi hallinta tietoihin - luo, lue, päivitä ja poista tietueita tavanomaisilla HTTP-pyynnöillä.

  • Varausten hallinta
  • Vierastiedot
  • Huoneen konfigurointi
  • Laskut ja maksut
Webhooks Reaaliaikainen

Saat välittömiä ilmoituksia järjestelmämuutoksista suoraan palvelimellesi.

  • Reaaliaikaiset ilmoitukset
  • Konfiguroitava tapahtuman laajuus
  • Suojattu HTTPS-yhteys
  • Automaattiset uudelleenyritykset
Kehittäjän lokit -paneeli

Seuraa kaikkia API-pyyntöjä ja vianmääritä integrointeja suoraan sovelluksessa.

  • API-pyynnön historia
  • Täydelliset palvelinvastaukset
  • Virheen tiedot
  • 30 päivän historia
Päätepisteet

Pääsy kaikkiin tietoihin

API tarjoaa päätepisteet kaikille keskeisille järjestelmäresursseille. Yksityiskohtainen dokumentaatio esimerkkien kanssa on saatavilla verkossa.

Näytä dokumentaatio
  • /reservations

    Lataa, luo ja muokkaa varauksia. Pääsy koko historiaan ja tiloihin.

  • /guests

    Hallitse vierasrekisteriä, yhteystietoja ja majoitushistoriaa.

  • /rooms

    Määritä huoneet, saatavuus, hinnat ja mukavuudet -ominaisuudet.

  • /invoices

    Luo laskuja, seuraa maksuja ja hallinnoi asiakirjoja.

POST Webhook Event
{
  "webhookId": "9b9b499e-095c-4955-8dd0-cc5d84e50764",
  "eventType": "reservation.created",
  "timestamp": "2025-10-10T15:39:07+02:00",
  "data": {
    "type": "SINGLE",
    "reservationId": [478652],
    "roomId": [28568],
    "arrival": "2025-10-14",
    "departure": "2025-10-16",
    "clientId": 362792,
    "triggeredBy": "MANUAL"
  }
}
Webhooks

Reaaliaikaiset ilmoitukset

Webhookit mahdollistavat automaattiset reaktiot järjestelmän tapahtumiin. Määritä päätepisteen URL ja vastaanota ilmoituksia uusista varauksista, muutoksista ja peruutuksista.

  • varaus.luotu - uusi varaus
  • reservation.updated - varauksen muutos
  • reservation.cancelled - varauksen peruutus
  • reservation.checked_in - vieras sisäänkirjautunut
Lisätietoja webhooksista

REST API saatavilla Premium-suunnitelmassa

Pääsy REST API:in, webhookeihin ja kehittäjälokien hallintapaneeliin sisältyy Premium-suunnitelmaan. Saat täyden hallinnan kiinteistösi integraatioista.

REST API FAQ

Usein kysytyt kysymykset

Etkö löytänyt etsimääsi? Tutustu ohjekeskukseen tai ota yhteyttä meihin.

Pääsy REST API:iin aktivoituu automaattisesti käyttäjille Premium-suunnitelmassa. Voit luoda API-avaimen tilin asetuksissa "Integraatiot"-osiossa.
Kaikki pyynnöt edellyttävät Authorization-otsikkoa Bearer-tokenin kanssa. Authorization-tiedot löytyvät API-dokumentaatiosta.
Kyllä, minuutissa sovelletaan 60 pyynnön rajoitusta. Jos sinulla on suurempia tarpeita, ota yhteyttä meihin.
Mene kohtaan tilin asetukset, osioon "Webhooks", lisää päätepisteen URL-osoite ja valitse tapahtumat, joista haluat saada ilmoituksia. Järjestelmä lähettää automaattisesti POST-ilmoituksen annettuun osoitteeseen.
API-dokumentaatio sisältää yksityiskohtaiset kuvaukset kaikista päätepisteistä esimerkkien kera. Lisäksi tekninen tukitiimimme on saatavilla chatin ja sähköpostin kautta.