HotelWebhotelier Σύνδεση
§ · ΟΔΗΓΟΣ API

Οδηγός Webhotelier API

Πρακτικός οδηγός για developers που χτίζουν custom ενσωματώσεις πάνω από τον λογαριασμό Webhotelier του ξενοδοχείου τους.

Authentication

Το Webhotelier API χρησιμοποιεί bearer token authentication. Το token εκδίδεται από το Extranet του Webhotelier (Ρυθμίσεις → API) και αποστέλλεται στην κεφαλίδα Authorization: Bearer <token>.

Βασικά endpoints

  • GET /v2/reservations?from=YYYY-MM-DD&to=YYYY-MM-DD — λίστα κρατήσεων περιόδου
  • GET /v2/availability — τρέχουσα διαθεσιμότητα ανά τύπο δωματίου
  • POST /v2/rates — καταχώρηση νέων τιμών
  • PATCH /v2/reservations/:id — τροποποίηση κράτησης

Rate limiting

Το Webhotelier επιβάλλει όρια 200 αιτημάτων ανά λεπτό ανά API key. Σε υπέρβαση επιστρέφεται 429 Too Many Requests με Retry-After κεφαλίδα. Οι ενότητες HotelWebhotelier χρησιμοποιούν token bucket algorithm για να αποφύγουν την υπέρβαση.

Webhooks

Το HotelWebhotelier μπορεί να στέλνει webhooks προς εσάς όταν συμβαίνουν συγκεκριμένα events (νέα κράτηση, τροποποίηση, ακύρωση). Ρυθμίστε στο /my-account → Ενσωματώσεις → Webhooks.