REST API

Comhtháthaigh do chóras le REST API

Faigh rochtain iomlán ar shonraí áirithinte, aíonna, agus seomraí tríd ár REST API. Déan próisis a uathoibriú agus comhtháthaigh an féilire soghluaiste le do chórais féin.

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"
  }
}
Cumasanna

API Cuimsitheach do Do Ghnó

Soláthraíonn ár n-API REST rochtain iomlán ar ghnéithe uile an chórais, ag cur ar chumas cruthú comhtháthú saincheaptha agus uathoibriú.

oibríochtaí CRUD

Smacht iomlán ar shonraí - cruthaigh, léigh, nuashonraigh, agus scrios taifid trí iarratais HTTP chaighdeánacha.

  • Bainistíocht Áirithintí
  • Sonraí aíonna
  • Cumraíocht Seomra
  • Sonraisc agus íocaíochtaí
Webhooks Fíor-Ama

Faigh fógraí meandaracha faoi athruithe córais go díreach ar do fhreastalaí.

  • Fógraí in am fíor
  • Raon imeachta inúsáidte
  • Nasc HTTPS Slán
  • Athiontaí uathoibríocha
Painéal Loganna Forbróra

Monatóireacht a dhéanamh ar gach iarratas API agus fabhtcheartú a dhéanamh ar chomhtháthaithe go díreach laistigh den fheidhmchlár.

  • Stair Iarraidh API
  • Freagraí iomlána an fhreastalaí
  • Sonraí Earráide
  • Stair 30-lá
Endpoints

Rochtain ar na sonraí go léir

Soláthraíonn an API aibhsí do gach acmhainn tábhachtach sa chóras. Tá doiciméadú mionsonraithe le samplaí ar fáil ar líne.

Féach ar dhoiciméadúchán
  • /reservations

    Íoslódáil, cruthaigh, agus cuir in eagar áirithintí. Rochtain ar stair iomlán agus stádais.

  • /guests

    Bainistigh an bunachar sonraí aíonna, faisnéis teagmhála, agus stair fanacht.

  • /rooms

    Cumraigh seomraí, infhaighteacht, rátaí, agus gnéithe taitneamhachtaí.

  • /invoices

    Gineadóir sonrasc, rian íocaíochtaí, agus bainistigh doiciméid.

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

Fógraí fíor-ama

Ceadaíonn Webhooks imoibrithe uathoibríocha ar imeachtaí sa chóras. Cumraigh an URL ceannphointe agus faigh fógraí faoi áirithintí nua, athruithe, agus cealúcháin.

  • reservation.created - áirithint nua
  • reservation.updated - modhnú ar an áirithint
  • reservation.cancelled - cealú áirithinte
  • áirithint.checked_in - seiceáil isteach an aoi
Tuilleadh eolais faoi webhooks

REST API ar fáil sa plean Préimhe

Tá rochtain ar REST API, webhooks, agus painéal na logaí forbróra mar chuid den phlean Préimhe. Faigh smacht iomlán ar chomhtháthuithe do mhaoin.

REST API FAQ

Ceisteanna Coitianta

Níor aimsigh tú an rud a bhí á lorg agat? Seiceáil an lárionad cabhrach nó déan teagmháil linn.

Cuirtear rochtain ar REST API i ngníomh go huathoibríoch d'úsáideoirí ar an bplean Préimhe. Is féidir leat eochair API a ghiniúint i socruithe an chuntais faoin rannán "Integrations".
Éilíonn gach iarratas ceanntásc Údaraithe le comhartha Bearer. Is féidir sonraí údaraithe a fháil sa doiciméadacht API.
Sea, tá teorainn 60 iarratas in aghaidh an nóiméid i bhfeidhm. Má tá riachtanais níos mó agat, déan teagmháil linn.
Téigh go dtí socruithe an chuntais, an rannán "Webhooks", cuir isteach an URL endpoint, agus roghnaigh na himeachtaí ar mhaith leat fógra a fháil faoi. Seolfaidh an córas fógra POST go huathoibríoch chuig an seoladh a sholáthraíodh.
Tá cur síos mionsonraithe ar gach ceann de na endpoints san fhoclaíocht API mar aon le samplaí. Ina theannta sin, tá ár bhfoireann tacaíochta teicniúla ar fáil trí chomhrá agus ríomhphost.