Ainult lugemiseks mõeldud andme-API ja partneri aktiveerimise süvalink Host Logicu AI-agentide integreerimiseks teie PMS-i või kinnisvarahaldusplatvormi. See leht dokumenteerib ainult seda, mis on täna live'is — selgelt märgistatud Roadmapi jaotis käsitleb seda, mis tuleb järgmisena.
Saage oma API-võti → lugege istekohtade kasutust ja hinnasignaale → lisage hosti aktiveerimislink oma kasutajaliidesesse. See on täielik integratsioonivoog, mis on täna saadaval.
Saage oma API-võti
Saage partneriks. Pärast heakskiitu loob Host Logic teie partnerikonto ja saadab teile ühekordse avalikustamislingi, mis sisaldab teie hlk_ API-võtit. Hoidke see turvaliselt — pärast avalikustamist ei saa seda enam uuesti kuvada.
Lugege kasutust & hinnasignaale
Kutsuge GET /partner-api/v1/usage, et jälgida istekohtade tarbimist, ja GET /partner-api/v1/properties/{id}/pricing-signals, et kuvada Marcuse hinnainfo oma platvormis.
Lisage aktiveerimislink
Lisage oma kasutajaliidesesse nupp, mis avab HMAC-iga allkirjastatud süvalingi https://hostlogic.io/partner/{slug}/activate?token=…. Hosti valib tooted, tema Host Logicu konto seadistatakse ning Laura on valmis.
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_your_key_here" \
-H "Accept: application/json"
# 200 OK — võti on kehtiv, vastus sisaldab teie istekohtade kasutust
# 401 Unauthorized — võti puudub või on kehtetu
# 403 Forbidden — võti on kehtiv, kuid vajalik ulatus puudub
# 429 Too Many Requests — kiirusepiirang (120 päringut/min)Kõik API-päringud nõuavad Bearer-tokenit Authorization päises. Te saate oma API-võtme pärast partneri heakskiitu ühekordse avalikustamislingi kaudu — lihtvõtit ei salvestata kunagi serveripoolselt ja seda ei saa uuesti kuvada.
API-võtmete eesliide on hlk_, need on seotud teie partnerikontoga ja neid saab seisakuta roteerida. Iga võti sisaldab õiguste kogumit, mis määrab, milliseid lõpp-punkte see võib kasutada. Iga võtme esimesed 12 märki (võtme eesliide) salvestatakse logides tuvastamiseks lihttekstina — ülejäänu on räsitud.
https://api.hostlogic.io/partner-api/v1
Sandbox / DEV:https://api-dev.hostlogic.io/partner-api/v1
120 päringut minutis API-võtme kohta. Piiri ületamisel tagastatakse 429 Too Many Requests.
metrics:read — antakse alati; katab kasutuse lõpp-punkti.marcus:read — antakse siis, kui teie partnerleping sisaldab Marcuse (Revenue Manager) andmeid; katab properties- ja pricing-signals-lõpp-punktid.
| Kood | Tähendus |
|---|---|
401 | API-võti puudub või on kehtetu |
403 | Võti on kehtiv, kuid selle lõpp-punkti jaoks vajalik õigus puudub |
404 | Ressurssi ei leitud või see ei kuulu teie partnerikontole |
429 | Päringute limiit ületatud — 120 päringut/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"Järgmised lõpp-punktid ja integratsioonimustrid on täna tootmiskeskkonnas kasutusel. Kõik siin loetletu on päriselt olemas ja kehtiva API-võtmega kasutatav.
/usage
Teie partnerikonto istekohtade kasutus. Ulatus: metrics:read (alati antud). Vaadake täielikku viidet allpool.
/properties
Loetleb teie sponsoreeritud hostidele kuuluvad majutusasutused. Ulatus: marcus:read. Vaadake täielikku viidet allpool.
/properties/{propertyId}/pricing-signals
Marcus'e hinnasignaalid ja eelseisev täituvus sponsoreeritud majutusasutuse jaoks. Ulatus: marcus:read. Vaadake täielikku viidet allpool.
Partneri aktiveerimise süvalink
HMAC-iga allkirjastatud URL, mis loob sponsoreeritud hostikonto. Lisatakse teie kasutajaliidesesse nupuna. Vaadake täielikku viidet allpool.
Tagastab autentitud partneri aktiivsete istekohtade arvu koos jaotusega hostide lõikes. Kasulik arvelduse kooskõlastamiseks või kasutuse juhtpaneeli loomiseks teie platvormis.
metrics:read — antakse alati kõigile partnerivõtmetele.
See lõpp-punkt tagastab andmeid ainult autentitud partneri kohta. See ei aktsepteeri kunagi partner_id päringuparameetrit — identiteet tuleb täielikult teie API-võtmest.
Jaotuses kasutatakse anonüümseid hosti kasutaja ID-sid ja istekohtade arvu. Hosti e-posti aadressid on tahtlikult välja jäetud.
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 }
]
}Tagastab kõik majutusasutused, mis kuuluvad hostidele, keda teie partnerikonto sponsoreerib. Kasutage seda, et leida, milliste majutusasutuste kohta saate hinnasignaale küsida.
marcus:read — antakse, kui teie partnerleping sisaldab Marcus Revenue Manageri andmeplatvormi.
Iga kirje sisaldab majutusasutuse sisemist id-d (vajalik pricing-signals lõpp-punkti jaoks) ja majutusasutuse name-i. Hosti PII, mis jääb väljapoole majutusasutuse nime, jäetakse välja.
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" }
]
}Tagastab Marcus'e hinnasignaalid ja eelseisva täituvuse ühe sponsoreeritud majutusasutuse kohta. Kasutage GET /properties kaudu tagastatud majutusasutuse id väärtusi. Kui majutusasutust ei leita või see ei kuulu teie partnerikontole, tagastatakse 404.
marcus:read
lookback_days (täisarv, vaikeväärtus 90) — broneerimisajaloo aken, mida kasutatakse signaalide arvutamiseks.
signals-objekt sisaldab hinnanäitajaid ja broneerimisstatistikat. Täpne väljade komplekt võib Marcus'e uute andmeallikate lisandumisel muutuda. Allolev näidis näitab käivitamisel saadaolevaid välju — käsitlege kõiki tundmatuid välju lisanditena.
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-kutse asemel võetakse partneri poolt sponsoreeritud hostid kasutusele allkirjastatud süvalingi kaudu. Host klõpsab sellel, jõuab hinnata turuplatsile, kus ta valib tooted, ning tema Host Logicu konto luuakse — sponsoreeritult ja ilma eraldi makseta.
https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>
Kus {slug} on teie partnerikonto unikaalne identifikaator (edastatakse liitumisel) ja token on HMAC-iga allkirjastatud lühiajaline andmepakett, mis sisaldab hosti identiteediväiteid.
Tokenid allkirjastatakse HMAC-SHA256 abil, kasutades teie partneri signing_secret-i (eraldi teie API-võtmest). Vorming on järgmine:
<base64url-payload>.<sha256-hmac>
Andmepakett sisaldab hosti identiteediväiteid, serveripoolset aegumisaega (exp) ning juhuslikku nonce'i tokeni korduskasutuse vältimiseks.
Vaikimisi: 1 tund. Aegunud tokenid lükatakse selge veateatega tagasi — hostid peavad taotlema uue lingi. Host Logic soovitab linke luua vajaduspõhiselt (nt siis, kui host klõpsab teie kasutajaliideses nuppu), mitte neid salvestada.
Praegu genereerib Host Logic aktiveerimistokenid soovi korral administraatori tööriista kaudu. Partneri iseteeninduslik tokenite loomine (tokenite programmiliselt genereerimine teie enda taustsüsteemist) on tegevuskavas — vt allpool.
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"
}| Samm | Mis juhtub |
|---|---|
| 1. Token kontrollitud | Host Logic valideerib HMAC-allkirja ja kontrollib aegumist. Vigaste või aegunud tokenite korral kuvatakse selge vealeht. |
| 2. Turuplats | Host jõuab hinnata toote turuplatsile, mis on seotud teie partnerlepinguga. Ta valib, millised tooted aktiveerida. |
| 3. Konto loodud | Luuakse sponsoreeritud Host Logicu hostikonto (või seotakse olemasolev, kui e-post juba eksisteerib). Tooted aktiveeritakse ilma maksesammuta. |
| 4. Onboarding | Hosti juhendatakse läbi Laura teadmistebaasi viisardi (sisseregistreerimise juhised, KKK, lisamüügi pakkumised). Laura hakkab külalistele vastama kohe pärast viisardi esitamist. |
Järgmised võimalused on planeeritud või arenduses. Need on siin läbipaistvuse huvides, et saaksite oma integratsioonitegevuskava planeerida. Ükski neist ei ole praegu kasutatav — nende vastu ehitamine põhjustab vigu.
Partneri iseteeninduslik tokenite loomine
API lõpp-punkt või allalaaditav SDK-koodilõik, mis võimaldab teie taustsüsteemil genereerida allkirjastatud aktiveerimistokeneid ilma Host Logicut kaasamata. Praegu genereeritakse tokenid soovi korral administraatori tööriista kaudu.
Kirjutamisõigused & muutvad lõpp-punktid
Õigused nagu marcus:write ja pierre:write ning REST-lõpp-punktid objektide registreerimiseks (POST /properties), üksikute üksuste aktiveerimiseks või deaktiveerimiseks ning partnerseadete uuendamiseks.
Veebikonksud / reaalajas sündmused
Push-teavitused onboarding'u lõpetamise, üksuse aktiveerimise/deaktiveerimise ja kasutuslävede kohta. Registreerige veebikonksu URL ja saate allkirjastatud andmepakette.
Partneri iseteenindusportaal
Lippudega juhitav iseteenindusportaal API-võtmete haldamiseks, istekohtade kasutuse vaatamiseks ja lubatud embed-lähteallikate seadistamiseks. Praegu privaatses beetaversioonis.
Pierre’i hoolduslõpp-punkt
GET /properties/{propertyId}/operational-state — sponsoreeritud majutusobjekti hooldus- ja tööolek. Valmis, kuid funktsioonilipuga keelatud; nõuab pierre:read õigust. Saadaval valitud partneritele soovi korral.
Liidestamise iframe’i sisestus
Sisestage Laura seadistusviisard iframe’ina oma PMS-i kasutajaliidesesse, kasutades postMessage sündmusi etapi edenemise ja lõpetamise jaoks. Sõltub partneri iseteenindusportaali käivitamisest.
Majutatud MCP-server ettevõtetele
Majutatud MCP-lõpp-punkt aadressil mcp.hostlogic.io, mis pakub Claude Desktopi / Cursori tööriistade juurdepääsu partneri ulatuses andmetele. Arhitektuur on planeeritud; ettevõttepartneritele veel ei ole aktiivne.
Ettevõttepartneritel on Host Logicu meeskonnaga eraldi Slacki kanal. Võtke ühendust aadressil [email protected], et arutada oma liidestusnõudeid ja ajakava.
Rääkige meile oma PMS-ist, kanalihaldurist või majutustarkvara tootest. Vaatame partneritaotlused läbi 2 tööpäeva jooksul ning anname teile API-võtme ja eraldi tugikanali.