API δεδομένων μόνο για ανάγνωση και deep-link ενεργοποίησης συνεργάτη για την ενσωμάτωση των πρακτόρων τεχνητής νοημοσύνης του Host Logic στο PMS ή στην πλατφόρμα διαχείρισης ακινήτων σας. Η σελίδα αυτή τεκμηριώνει μόνο ό,τι είναι ενεργό σήμερα — μια σαφώς επισημασμένη ενότητα Roadmap καλύπτει ό,τι έρχεται στη συνέχεια.
Αποκτήστε το κλειδί API σας → διαβάστε τη χρήση θέσεων και τα σήματα τιμολόγησης → ενσωματώστε τον σύνδεσμο ενεργοποίησης οικοδεσπότη στο UI σας. Αυτός είναι ο πλήρης βρόχος ενσωμάτωσης που είναι διαθέσιμος σήμερα.
Αποκτήστε το κλειδί API σας
Γίνετε συνεργάτης. Μόλις εγκριθείτε, το Host Logic δημιουργεί τον λογαριασμό συνεργάτη σας και σας στέλνει έναν σύνδεσμο μοναδικής αποκάλυψης που περιέχει το κλειδί API hlk_. Αποθηκεύστε το με ασφάλεια — δεν μπορεί να εμφανιστεί ξανά μετά την αποκάλυψη.
Διαβάστε τα σήματα χρήσης & τιμολόγησης
Καλέστε το GET /partner-api/v1/usage για να παρακολουθείτε την κατανάλωση θέσεων, και το GET /partner-api/v1/properties/{id}/pricing-signals για να εμφανίζετε τα δεδομένα τιμολόγησης του Marcus μέσα στην πλατφόρμα σας.
Ενσωματώστε τον σύνδεσμο ενεργοποίησης
Προσθέστε ένα κουμπί στο UI σας που ανοίγει το HMAC-signed deep-link https://hostlogic.io/partner/{slug}/activate?token=…. Ο οικοδεσπότης επιλέγει προϊόντα, ο λογαριασμός Host Logic του δημιουργείται, και η Laura είναι έτοιμη.
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_your_key_here" \
-H "Accept: application/json"
# 200 OK — key is valid, response contains your seat usage
# 401 Unauthorized — key missing or invalid
# 403 Forbidden — key valid but missing required scope
# 429 Too Many Requests — rate limit (120 req/min)Όλα τα αιτήματα API απαιτούν ένα Bearer token στην κεφαλίδα Authorization. Λαμβάνετε το κλειδί API σας μετά την έγκριση του συνεργάτη μέσω ενός συνδέσμου μοναδικής αποκάλυψης — το απλό κλειδί δεν αποθηκεύεται ποτέ στην πλευρά του διακομιστή και δεν μπορεί να εμφανιστεί ξανά.
Τα κλειδιά API φέρουν το πρόθεμα hlk_, περιορίζονται στον λογαριασμό συνεργάτη σας και μπορούν να εναλλάσσονται χωρίς διακοπή λειτουργίας. Κάθε κλειδί φέρει ένα σύνολο scopes που καθορίζουν ποια endpoints μπορεί να καλέσει. Οι πρώτοι 12 χαρακτήρες κάθε κλειδιού (το πρόθεμα του κλειδιού) αποθηκεύονται σε απλό κείμενο για την αναγνώριση στα logs — το υπόλοιπο είναι hashed.
https://api.hostlogic.io/partner-api/v1
Sandbox / DEV:https://api-dev.hostlogic.io/partner-api/v1
120 αιτήματα/λεπτό ανά κλειδί API. Η υπέρβαση επιστρέφει 429 Too Many Requests.
metrics:read — παραχωρείται πάντα· καλύπτει το endpoint χρήσης.marcus:read — παραχωρείται όταν η συμφωνία συνεργασίας σας περιλαμβάνει δεδομένα του Marcus (Revenue Manager)· καλύπτει τα endpoints ακινήτων και σημάτων τιμολόγησης.
| Κωδικός | Σημασία |
|---|---|
401 | Απόν ή μη έγκυρο κλειδί API |
403 | Έγκυρο κλειδί, αλλά λείπει το απαιτούμενο scope για αυτό το endpoint |
404 | Ο πόρος δεν βρέθηκε ή δεν ανήκει στον λογαριασμό συνεργάτη σας |
429 | Υπέρβαση ορίου ρυθμού — 120 req/min |
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
-H "Accept: application/json"curl https://api.hostlogic.io/partner-api/v1/usage \
-H "X-Enterprise-Key: hlk_a8f3c2e1b4d5..." \
-H "Accept: application/json"Τα ακόλουθα endpoints και μοτίβα ενσωμάτωσης βρίσκονται σε παραγωγή σήμερα. Όλα όσα αναφέρονται εδώ είναι πραγματικά και μπορούν να κληθούν με ένα έγκυρο κλειδί API.
/usage
Χρήση θέσεων για τον λογαριασμό συνεργάτη σας. Scope: metrics:read (παραχωρείται πάντα). Δείτε την πλήρη αναφορά παρακάτω.
/properties
Λίστα ακινήτων που ανήκουν στους χορηγούμενους οικοδεσπότες σας. Scope: marcus:read. Δείτε την πλήρη αναφορά παρακάτω.
/properties/{propertyId}/pricing-signals
Σήματα τιμολόγησης του Marcus και επερχόμενη πληρότητα για ένα χορηγούμενο ακίνητο. Scope: marcus:read. Δείτε την πλήρη αναφορά παρακάτω.
Deep-link ενεργοποίησης συνεργάτη
HMAC-signed URL που δημιουργεί έναν χορηγούμενο λογαριασμό οικοδεσπότη. Ενσωματώνεται στο UI σας ως κουμπί. Δείτε την πλήρη αναφορά παρακάτω.
Επιστρέφει τον αριθμό ενεργών θέσεων του πιστοποιημένου συνεργάτη με ανάλυση ανά οικοδεσπότη. Χρήσιμο για τη συμφωνία χρεώσεων ή για τη δημιουργία ενός dashboard χρήσης μέσα στην πλατφόρμα σας.
metrics:read — παραχωρείται πάντα σε όλα τα κλειδιά συνεργατών.
Αυτό το endpoint επιστρέφει δεδομένα μόνο για τον πιστοποιημένο συνεργάτη. Δεν δέχεται ποτέ παράμετρο query partner_id — η ταυτότητα προκύπτει εξ ολοκλήρου από το κλειδί API σας.
Η ανάλυση χρησιμοποιεί αδιαφανή IDs χρηστών οικοδεσποτών και αριθμούς θέσεων. Τα emails των οικοδεσποτών εξαιρούνται σκόπιμα.
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
-H "Accept: application/json"{
"partner_id": 1,
"generated_at": "2026-06-01T10:30:00Z",
"active_seats": 7,
"hosts": [
{ "host_user_id": 42, "active_seats": 4 },
{ "host_user_id": 67, "active_seats": 3 }
]
}Επιστρέφει όλα τα ακίνητα που ανήκουν στους οικοδεσπότες που χορηγεί ο λογαριασμός συνεργάτη σας. Χρησιμοποιήστε το για να ανακαλύψετε ποια ακίνητα μπορείτε να ερωτήσετε για σήματα τιμολόγησης.
marcus:read — παραχωρείται όταν η συμφωνία συνεργασίας σας περιλαμβάνει το data plane του Marcus Revenue Manager.
Κάθε εγγραφή περιέχει το εσωτερικό id του ακινήτου (απαιτείται για το endpoint σημάτων τιμολόγησης) και το name του ακινήτου. Τα PII του οικοδεσπότη πέραν του ονόματος του ακινήτου εξαιρούνται.
curl https://api.hostlogic.io/partner-api/v1/properties \
-H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
-H "Accept: application/json"{
"partner_id": 1,
"generated_at": "2026-06-01T10:30:00Z",
"properties": [
{ "id": 12, "name": "Harbour View Apartment" },
{ "id": 17, "name": "Old Town Studio" }
]
}Επιστρέφει σήματα τιμολόγησης του Marcus και επερχόμενη πληρότητα για ένα μεμονωμένο χορηγούμενο ακίνητο. Χρησιμοποιήστε τις τιμές id ακινήτου που επιστρέφει το GET /properties. Επιστρέφεται ένα 404 εάν το ακίνητο δεν βρεθεί ή δεν ανήκει στον λογαριασμό συνεργάτη σας.
marcus:read
lookback_days (ακέραιος, προεπιλογή 90) — το παράθυρο ιστορικού κρατήσεων που χρησιμοποιείται για τον υπολογισμό των σημάτων.
Το αντικείμενο signals περιέχει δείκτες τιμολόγησης και στατιστικά κρατήσεων. Το ακριβές σύνολο πεδίων μπορεί να εξελιχθεί καθώς ο Marcus προσθέτει νέες πηγές δεδομένων. Το αντιπροσωπευτικό παράδειγμα παρακάτω δείχνει τα πεδία που είναι διαθέσιμα κατά την έναρξη — αντιμετωπίστε οποιαδήποτε μη αναγνωρισμένα πεδία ως πρόσθετα.
curl "https://api.hostlogic.io/partner-api/v1/properties/12/pricing-signals?lookback_days=90" \
-H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
-H "Accept: application/json"{
"property_id": 12,
"signals": {
"occupancy_today": 0.75,
"avg_lead_time_days": 18.4,
"avg_stay_nights": 3.2,
"source_mix": {
"booking.com": 0.62,
"direct": 0.38
},
"total_reservations": 87
},
"occupancy_30d": {
"2026-06-01": 0.75,
"2026-06-02": 0.80
}
}Αντί για μια κλήση REST, οι οικοδεσπότες που χορηγούνται από συνεργάτη εντάσσονται μέσω ενός signed deep-link. Ο οικοδεσπότης το κάνει κλικ, φτάνει σε ένα marketplace χωρίς τιμές όπου επιλέγει προϊόντα, και ο λογαριασμός Host Logic του δημιουργείται — χορηγούμενος και χωρίς να απαιτείται ξεχωριστή πληρωμή.
https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>
Όπου {slug} είναι το μοναδικό αναγνωριστικό του λογαριασμού συνεργάτη σας (παρέχεται κατά την ένταξη) και token είναι ένα HMAC-signed, βραχύβιο payload που μεταφέρει claims ταυτότητας οικοδεσπότη.
Τα tokens υπογράφονται με HMAC-SHA256 χρησιμοποιώντας το signing_secret του συνεργάτη σας (ξεχωριστό από το κλειδί API σας). Η μορφή είναι:
<base64url-payload>.<sha256-hmac>
Το payload μεταφέρει claims ταυτότητας οικοδεσπότη, ένα timestamp λήξης στην πλευρά του διακομιστή (exp), και ένα τυχαίο nonce για την αποτροπή επαναχρησιμοποίησης του token.
Προεπιλογή: 1 ώρα. Τα ληγμένα tokens απορρίπτονται με ένα σαφές σφάλμα — οι οικοδεσπότες πρέπει να ζητήσουν έναν νέο σύνδεσμο. Το Host Logic συνιστά τη δημιουργία συνδέσμων on-demand (π.χ. όταν ένας οικοδεσπότης κάνει κλικ σε ένα κουμπί στο UI σας) αντί της αποθήκευσής τους.
Σήμερα, τα tokens ενεργοποίησης δημιουργούνται μέσω ενός εργαλείου διαχειριστή από το Host Logic κατόπιν αιτήματος. Η δημιουργία tokens με αυτοεξυπηρέτηση από τον συνεργάτη (προγραμματιστική δημιουργία tokens από το δικό σας backend) βρίσκεται στο Roadmap — δείτε παρακάτω.
https://hostlogic.io/partner/previo/activate
?token=eyJjb250YWN0X2VtYWlsIjoiaG9zdEBleGFtcGxlLmNvbSIsImV4cCI6MTc1MDAwMDAwMCwibm9uY2UiOiJhYjEyY2QzNCJ9.a1b2c3d4e5f6...<!-- Simple button — opens in a new tab -->
<a href="{{ $activationUrl }}" target="_blank" class="btn">
Set up AI Receptionist →
</a>{
"contact_email": "[email protected]",
"contact_name": "Hotel Adriatic",
"previo_hotel_id": "779307",
"requested_product_ids": ["laura-receptionist"],
"exp": 1750000000,
"nonce": "ab12cd34"
}| Βήμα | Τι συμβαίνει |
|---|---|
| 1. Το token επαληθεύεται | Το Host Logic επικυρώνει την υπογραφή HMAC και ελέγχει τη λήξη. Τα μη έγκυρα ή ληγμένα tokens εμφανίζουν μια σαφή σελίδα σφάλματος. |
| 2. Marketplace | Ο οικοδεσπότης φτάνει σε ένα marketplace προϊόντων χωρίς τιμές, περιορισμένο στη συμφωνία συνεργασίας σας. Επιλέγει ποια προϊόντα θα ενεργοποιήσει. |
| 3. Ο λογαριασμός δημιουργείται | Δημιουργείται ένας χορηγούμενος λογαριασμός οικοδεσπότη Host Logic (ή συνδέεται εάν το email υπάρχει ήδη). Τα προϊόντα ενεργοποιούνται χωρίς βήμα πληρωμής. |
| 4. Ένταξη | Ο οικοδεσπότης καθοδηγείται μέσα από τον οδηγό βάσης γνώσης της Laura (οδηγίες check-in, FAQs, προσφορές upsell). Η Laura αρχίζει να απαντά στους επισκέπτες μόλις υποβληθεί ο οδηγός. |
Οι ακόλουθες δυνατότητες είναι προγραμματισμένες ή υπό ανάπτυξη. Παρατίθενται εδώ για διαφάνεια ώστε να μπορείτε να σχεδιάσετε το roadmap ενσωμάτωσής σας. Καμία από αυτές δεν μπορεί να κληθεί σήμερα — η ανάπτυξη με βάση αυτές τώρα θα οδηγήσει σε σφάλματα.
Δημιουργία tokens με αυτοεξυπηρέτηση συνεργάτη
Ένα endpoint API ή ένα snippet SDK προς λήψη που επιτρέπει στο backend σας να δημιουργεί signed tokens ενεργοποίησης χωρίς τη συμμετοχή του Host Logic. Σήμερα τα tokens δημιουργούνται κατόπιν αιτήματος μέσω ενός εργαλείου διαχειριστή.
Write scopes & endpoints μεταβολής
Scopes όπως marcus:write και pierre:write και endpoints REST για την καταχώριση ακινήτων (POST /properties), την ενεργοποίηση ή απενεργοποίηση μεμονωμένων μονάδων, και την ενημέρωση των ρυθμίσεων συνεργάτη.
Webhooks / συμβάντα σε πραγματικό χρόνο
Ειδοποιήσεις push για ολοκλήρωση ένταξης, ενεργοποίηση/απενεργοποίηση μονάδας, και όρια χρήσης. Καταχωρίστε ένα URL webhook και λάβετε signed payloads.
Portal αυτοεξυπηρέτησης συνεργάτη
Ένα portal αυτοεξυπηρέτησης, ελεγχόμενο από flag, για τη διαχείριση κλειδιών API, την προβολή της χρήσης θέσεων, και τη διαμόρφωση των επιτρεπόμενων origins ενσωμάτωσης. Επί του παρόντος σε private beta.
Endpoint συντήρησης του Pierre
GET /properties/{propertyId}/operational-state — κατάσταση συντήρησης και λειτουργίας για ένα χορηγούμενο ακίνητο. Κατασκευασμένο αλλά απενεργοποιημένο από ένα feature flag· απαιτεί το scope pierre:read. Διαθέσιμο σε επιλεγμένους συνεργάτες κατόπιν αιτήματος.
Ενσωμάτωση iframe ένταξης
Ενσωματώστε τον οδηγό διαμόρφωσης της Laura ως iframe στο UI του PMS σας, με συμβάντα postMessage για την πρόοδο και την ολοκλήρωση των βημάτων. Εξαρτάται από την κυκλοφορία του portal αυτοεξυπηρέτησης συνεργάτη.
Φιλοξενούμενος MCP server για enterprise
Ένα φιλοξενούμενο endpoint MCP στο mcp.hostlogic.io που παρέχει πρόσβαση εργαλείων Claude Desktop / Cursor σε δεδομένα περιορισμένα στον συνεργάτη. Η αρχιτεκτονική είναι σχεδιασμένη· δεν είναι ακόμη ενεργό για enterprise συνεργάτες.
Οι enterprise συνεργάτες έχουν ένα αποκλειστικό κανάλι Slack με την ομάδα του Host Logic. Επικοινωνήστε στο [email protected] για να συζητήσετε τις απαιτήσεις ενσωμάτωσης και το χρονοδιάγραμμά σας.
Πείτε μας για το PMS, τον channel manager ή το προϊόν λογισμικού φιλοξενίας σας. Εξετάζουμε τις αιτήσεις συνεργατών εντός 2 εργάσιμων ημερών και παρέχουμε το κλειδί API σας και ένα αποκλειστικό κανάλι υποστήριξης.