Κάθε κατάλυμα έχει το δικό του API key και υπογεγραμμένα webhooks σε πραγματικό χρόνο για νέες, τροποποιημένες και ακυρωμένες κρατήσεις. Τροφοδοτήστε σύστημα πρόσβασης, BI dashboard, λογιστικό πρόγραμμα ή POS του μπαρ χωρίς να εξάγετε spreadsheet.
reservation.created
Παραδόθηκε με την πρώτη προσπάθεια
reservation.updated
Η προσπάθεια 1 απέτυχε, νέα σε 1 λεπτό
reservation.updated
Παραδόθηκε στη 2η προσπάθεια
reservation.cancelled
Παραδόθηκε με την πρώτη προσπάθεια
Υπογραφή HMAC-SHA256 · Επαναλήψεις μετά από 1, 5 και 30 λεπτά
Στην καθημερινή σας δουλειά
Συνδέστε τα HTTPS endpoints σας στα reservation.created, reservation.updated και reservation.cancelled. Κάθε γεγονός φτάνει ως JSON με ημερομηνίες, δωμάτια, τύπους δωματίων, επισκέπτες, πηγή και ειδικά αιτήματα, και οι ενημερώσεις περιέχουν και τις προηγούμενες τιμές των πεδίων που άλλαξαν.
Δημιουργήστε ένα key στη σελίδα Developers του Roomismo και στείλτε το στο header x-api-key ενός GraphQL αιτήματος. Το key αντιστοιχεί σε ένα κατάλυμα, μπορεί να απενεργοποιηθεί ή να ανανεωθεί οποιαδήποτε στιγμή και το Roomismo αποθηκεύει μόνο το hash του.
Δημιουργήστε και ενημερώστε αιτήματα υπηρεσιών από εφαρμογή εστιατορίου, μπαρ ή spa μέσω του ίδιου API, με προϊόντα, ποσότητες και ΦΠΑ, ώστε μια παραγγελία από το pool bar να χρεωθεί στο δωμάτιο και να εμφανιστεί στην κράτηση του επισκέπτη.
Στον πραγματικό κόσμο τα webhooks αποτυγχάνουν: servers κάνουν restart, πιστοποιητικά λήγουν, deploys πάνε στραβά. Το Roomismo υπογράφει, επαναλαμβάνει και καταγράφει κάθε αποστολή, ώστε η σύνδεσή σας να επανέρχεται χωρίς να ξαναπερνάει κανείς δεδομένα.
Κάθε αποστολή έχει header X-Roomismo-Signature με χρονοσφραγίδα και υπογραφή HMAC-SHA256 με το secret του καταλύματός σας, ώστε το endpoint σας να απορρίπτει πλαστές ή επαναλαμβανόμενες κλήσεις. Μπορείτε να ανανεώσετε το secret όποτε χρειαστεί.
Αν το endpoint σας δεν απαντήσει με κωδικό 2xx μέσα σε 30 δευτερόλεπτα, το Roomismo ξαναπροσπαθεί μετά από 1 λεπτό, 5 λεπτά και 30 λεπτά. Αν αποτύχουν και οι τέσσερις προσπάθειες, οι χρήστες με πρόσβαση στις ρυθμίσεις του καταλύματος λαμβάνουν email.
Η σελίδα Developers δείχνει κάθε γεγονός με την κατάσταση, τον κωδικό απάντησης, τον αριθμό προσπαθειών, το τελευταίο σφάλμα και ολόκληρο το payload. Ένα αποτυχημένο γεγονός ξαναστέλνεται με ένα κλικ μόλις διορθωθεί το endpoint σας.
Κάθε endpoint είναι κλειδωμένο σε μια έκδοση payload (σήμερα 2026-01-01) και μπορείτε να δηλώσετε πολλά endpoints ανά γεγονός. Μια μελλοντική αλλαγή στο payload φτάνει στη σύνδεσή σας μόνο όταν αλλάξετε έκδοση.
Η σελίδα Developers περιγράφει κάθε λειτουργία που είναι διαθέσιμη στα API keys, με τα ορίσματα, τα πεδία επιστροφής και ένα έτοιμο παράδειγμα αιτήματος.
Φτιάχνουμε έναν Model Context Protocol server ώστε AI agents όπως το Claude ή το ChatGPT να δουλεύουν με τα δεδομένα σας στο Roomismo, με τους ίδιους κανόνες πρόσβασης ανά κατάλυμα. Ρωτήστε μας στο demo σας.
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" }
}
}Γνωρίστε τις λειτουργίες μαζί με την ομάδα μας και βρείτε τη ρύθμιση που ταιριάζει στο κατάλυμά σας.