Κλειδιά API και webhooks
Σύνδεση με άλλα προγράμματα (λογιστικό, εφαρμογές, ιστοσελίδες): κλειδιά API με δικαιώματα, και webhooks που ενημερώνουν ένα άλλο σύστημα για κάθε παραγγελία.
Και τα δύο είναι στο Για προχωρημένους και τα βλέπει μόνο ο ιδιοκτήτης. Οι λεπτομέρειες για προγραμματιστές είναι στην Τεκμηρίωση API (/api/docs).
Κλειδιά API
- Κλειδιά API → Νέο κλειδί. Δώστε Όνομα (π.χ. Λογιστικό) και διαλέξτε Δικαιώματα: Μενού: ανάγνωση, Μενού: αλλαγές, Παραγγελίες: ανάγνωση, Παραγγελίες: δημιουργία/κατάσταση, Κλήσεις: αναγνώριση κλήσης (τηλεφωνικό κέντρο), PMS ξενοδοχείου: δωμάτια, διαμονές, χρεώσεις δωματίου (με το πρόσθετο Σύνδεση PMS ξενοδοχείου, δείτε Hotel API για παρόχους PMS).
- Αντιγράψτε το κλειδί αμέσως: δεν θα εμφανιστεί ξανά.
- Το άλλο πρόγραμμα το στέλνει ως
Authorization: Bearer ….
Δώστε μόνο τα δικαιώματα που χρειάζονται. Η στήλη Τελευταία χρήση δείχνει αν χρησιμοποιείται. Με Ανάκληση, ό,τι χρησιμοποιεί το κλειδί σταματά αμέσως.
Webhooks
Ένα άλλο σύστημα ενημερώνεται αμέσως για τα Γεγονότα που διαλέγετε: νέα online παραγγελία, αποδοχή, απόρριψη, έτοιμη, πληρώθηκε / έκλεισε, ακυρώθηκε, και χρέωση δωματίου (PMS ξενοδοχείου).
- Η διεύθυνση πρέπει να είναι https και να απαντά 2xx μέσα σε 10 δευτερόλεπτα.
- Αν αποτύχει, ξαναδοκιμάζει 5 φορές. Μετά από 20 συνεχόμενες αποτυχίες το webhook απενεργοποιείται.
- Κάθε κλήση υπογράφεται με το Μυστικό του webhook (κεφαλίδα X-Ikaros-Signature, HMAC-SHA256). Ελέγχετε την υπογραφή πριν δεχτείτε την κλήση.
- Με Δοκιμή στέλνετε μια δοκιμαστική κλήση. Τελευταία αποστολή και Τελευταίο σφάλμα δείχνουν τι έγινε.