Zhvilluesit dhe API e hapur

Lidheni Roomismo me sistemet që përdorni tashmë

Çdo pronë merr çelësin e vet API dhe webhook të nënshkruar në kohë reale për rezervimet e reja, të ndryshuara dhe të anuluara. Ushqeni një sistem aksesi në dyer, një panel BI, programin tuaj të kontabilitetit ose POS-in e barit pa eksportuar asnjë tabelë.

Shihni si funksionon
RoomismoShembull ilustrues

Historiku i dërgimeve të webhook-ëve

  1. reservation.created

    U dërgua në përpjekjen e parë

    200
  2. reservation.updated

    Përpjekja 1 dështoi, provohet sërish pas 1 minute

    503
  3. reservation.updated

    U dërgua në përpjekjen e 2-të

    200
  4. reservation.cancelled

    U dërgua në përpjekjen e parë

    200

I nënshkruar me HMAC-SHA256 · Riprovime pas 1, 5 dhe 30 minutash

Në punën tuaj të përditshme

Mësoni për çdo ndryshim rezervimi në kohë reale

Abonojini endpoint-et tuaja HTTPS te reservation.created, reservation.updated dhe reservation.cancelled. Çdo ngjarje vjen si JSON me datat, dhomat, llojet e dhomave, mysafirët, burimin dhe kërkesat e veçanta, ndërsa përditësimet përmbajnë edhe vlerat e mëparshme të fushave që ndryshuan.

Kërkoni rezervime dhe dhoma me një çelës API

Krijoni një çelës te faqja Developers në Roomismo dhe dërgojeni në header-in x-api-key të një kërkese GraphQL. Çelësi lidhet me një pronë, mund ta pezulloni ose ta rigjeneroni në çdo kohë, dhe Roomismo ruan vetëm një hash të tij.

Regjistroni tarifa nga sistemet tuaja të tjera

Krijoni dhe përditësoni kërkesa shërbimi nga aplikacioni i restorantit, barit ose spa-s përmes të njëjtës API, me produkte, sasi dhe TVSH, që një porosi nga bari i pishinës të tarifohet në dhomën e mysafirit dhe të shfaqet në rezervimin e tij.

I ndërtuar për zhvilluesin që duhet ta mirëmbajë

Në botën reale webhook-ët dështojnë: serverët rinisen, certifikatat skadojnë, deploy-et dalin keq. Roomismo e nënshkruan, e riprovon dhe e regjistron çdo dërgim, që integrimi juaj të rimëkëmbet pa i rifutur askush të dhënat.

I nënshkruar me HMAC-SHA256

Çdo dërgim ka header-in X-Roomismo-Signature me një vulë kohore dhe një nënshkrim HMAC-SHA256 të bërë me sekretin e pronës suaj, që endpoint-i juaj të refuzojë thirrjet e falsifikuara ose të përsëritura. Sekretin mund ta rigjeneroni sa herë t'ju duhet.

Riprovime automatike

Nëse endpoint-i juaj nuk përgjigjet me status 2xx brenda 30 sekondave, Roomismo provon sërish pas 1 minute, 5 minutash dhe 30 minutash. Nëse dështojnë të katër përpjekjet, përdoruesit me akses te cilësimet e pronës marrin një email.

Historik dërgimesh që mund ta kontrolloni

Faqja Developers liston çdo ngjarje me statusin, kodin e përgjigjes, numrin e përpjekjeve, gabimin e fundit dhe payload-in e plotë. Një ngjarje e dështuar mund të ridërgohet me një klikim, sapo të rregulloni endpoint-in.

Payload me versione

Çdo endpoint lidhet me një version payload-i (aktualisht 2026-01-01), dhe për çdo ngjarje mund të regjistroni disa endpoint. Një ndryshim i ardhshëm i payload-it arrin te integrimi juaj vetëm kur ndërroni versionin.

Dokumentacion brenda aplikacionit

Faqja Developers dokumenton çdo operacion që u ofrohet çelësave API, me argumentet, fushat që kthehen dhe një shembull kërkese gati për t'u kopjuar.

Së shpejti

Mbështetje për server MCP

Po ndërtojmë një server Model Context Protocol që agjentët AI si Claude ose ChatGPT të mund të punojnë me të dhënat tuaja në Roomismo, me të njëjtat rregulla aksesi për çdo pronë. Pyetni për të gjatë demos.

Shembull payload-i reservation.updated (vlera ilustruese)
POST https://your-system.example.com/roomismo
X-Roomismo-Event: reservation.updated
X-Roomismo-Signature: t=1767225600,v1=5f2b9c…

{
  "id": "evt_a1B2c3",
  "object": "event",
  "type": "reservation.updated",
  "api_version": "2026-01-01",
  "data": {
    "object": {
      "reservationNumber": "R-10482",
      "status": "new",
      "arrivalDate": "2026-07-14T00:00:00.000Z",
      "departureDate": "2026-07-18T00:00:00.000Z",
      "source": "website",
      "mainGuest": { "firstname": "Maria", "lastname": "Papadopoulou" },
      "rooms": [{ "room": "204", "roomType": "Double Sea View", "guestCount": 2 }]
    },
    "previous_attributes": { "departureDate": "2026-07-17T00:00:00.000Z" }
  }
}

Disa gjëra për të ditur

Shihni si funksionon për pronën tuaj

Kaloni nëpër funksionet me ekipin tonë dhe gjeni konfigurimin që i përshtatet pronës suaj.