Developeri i otvoreni API

Povežite Roomismo sa sustavima koje već koristite

Svaki objekt dobiva vlastiti API ključ i potpisane webhookove u stvarnom vremenu za nove, izmijenjene i otkazane rezervacije. Napajajte sustav kontrole pristupa, BI nadzornu ploču, računovodstveni alat ili POS u baru bez izvoza tablica.

Pogledajte kako radi
RoomismoIlustrativni primjer

Povijest isporuka webhookova

  1. reservation.created

    Isporučeno u prvom pokušaju

    200

  2. reservation.updated

    Pokušaj 1 nije uspio, novi za 1 minutu

    503

  3. reservation.updated

    Isporučeno u 2. pokušaju

    200

  4. reservation.cancelled

    Isporučeno u prvom pokušaju

    200

Potpis HMAC-SHA256 · Ponovni pokušaji nakon 1, 5 i 30 minuta

U vašem svakodnevnom radu

Saznajte za svaku promjenu rezervacije u stvarnom vremenu

Pretplatite svoje HTTPS endpointe na reservation.created, reservation.updated i reservation.cancelled. Svaki događaj stiže kao JSON s datumima, sobama, vrstama soba, gostima, izvorom i posebnim zahtjevima, a ažuriranja sadrže i prethodne vrijednosti promijenjenih polja.

Dohvaćajte rezervacije i sobe API ključem

Izradite ključ na stranici Developers u Roomismu i pošaljite ga u zaglavlju x-api-key GraphQL zahtjeva. Ključ je vezan uz jedan objekt, možete ga u bilo kojem trenutku pauzirati ili ponovno generirati, a Roomismo pohranjuje samo njegov hash.

Knjižite troškove iz drugih sustava

Kroz isti API izradite i ažurirajte zahtjeve za uslugom iz aplikacije restorana, bara ili spa centra, s proizvodima, količinama i PDV-om, tako da se narudžba iz bara uz bazen naplati na sobu i pojavi na rezervaciji gosta.

Izrađeno za developera koji to mora održavati

U stvarnom svijetu webhookovi ne uspijevaju: poslužitelji se ponovno pokreću, certifikati istječu, deployi pođu po zlu. Roomismo potpisuje, ponavlja i bilježi svaku isporuku kako bi se vaša integracija oporavila bez ponovnog unosa podataka.

Potpis HMAC-SHA256

Svaka isporuka ima zaglavlje X-Roomismo-Signature s vremenskom oznakom i HMAC-SHA256 potpisom izrađenim tajnim ključem vašeg objekta, pa vaš endpoint može odbiti krivotvorene ili ponovljene pozive. Tajni ključ možete ponovno generirati kad god zatreba.

Automatski ponovni pokušaji

Ako vaš endpoint ne odgovori statusom 2xx unutar 30 sekundi, Roomismo pokušava ponovno nakon 1 minute, 5 minuta i 30 minuta. Ako ne uspiju sva četiri pokušaja, korisnici s pristupom postavkama objekta dobivaju e-mail.

Povijest isporuka koju možete pregledati

Stranica Developers prikazuje svaki događaj sa statusom, kodom odgovora, brojem pokušaja, zadnjom greškom i cijelim payloadom. Neuspjeli događaj šaljete ponovno jednim klikom kad popravite endpoint.

Verzionirani payloadi

Svaki endpoint vezan je uz verziju payloada (trenutačno 2026-01-01), a po događaju možete registrirati više endpointa. Buduća promjena payloada stiže do vaše integracije tek kad promijenite verziju.

Dokumentacija u aplikaciji

Stranica Developers opisuje svaku operaciju dostupnu API ključevima, s argumentima, povratnim poljima i primjerom zahtjeva spremnim za kopiranje.

Uskoro

Podrška za MCP poslužitelj

Gradimo Model Context Protocol poslužitelj kako bi AI agenti poput Claudea ili ChatGPT-a mogli raditi s vašim Roomismo podacima, uz ista pravila pristupa po objektu. Pitajte nas na demonstraciji.

Primjer payloada reservation.updated (ilustrativne vrijednosti)
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" }
  }
}

Nekoliko stvari koje trebate znati

Radi uz vaše ostale procese

Pristup za vlasnike i tim

Ovlasti po objektu i po odjeljku

AI asistent

Ugrađen za timove objekata

Pogledajte kako radi za vaš objekt

Prođite kroz funkcije s našim timom i pronađite postavke koje odgovaraju vašem objektu.