Vain lukuoikeudella toimiva data-API ja kumppanin aktivointiin tarkoitettu syvälinkki Host Logicin AI-agenttien integroimiseksi PMS-järjestelmäänne tai kiinteistöhallinta-alustaanne. Tällä sivulla dokumentoidaan vain se, mikä on tänään käytössä — selkeästi merkitty Roadmap-osio kattaa tulevat ominaisuudet.
Hanki API-avaimenne → lue istumapaikkojen käyttö ja hinnoittelusignaalit → upota isännän aktivointilinkki käyttöliittymäänne. Tämä on koko tämänhetkinen integraatiokokonaisuus.
Hanki API-avaimenne
Tule kumppaniksi. Hyväksynnän jälkeen Host Logic luo kumppanitilinne ja lähettää teille kertakäyttöisen paljastuslinkin, joka sisältää hlk_-API-avaimenne. Säilyttäkää se turvallisesti — sitä ei voi näyttää uudelleen paljastamisen jälkeen.
Lue käyttö- ja hinnoittelusignaalit
Kutsukaa GET /partner-api/v1/usage seurataksenne istumapaikkojen käyttöä ja GET /partner-api/v1/properties/{id}/pricing-signals näyttääksenne Marcusin hinnoittelutiedot alustallanne.
Upota aktivointilinkki
Lisätkää käyttöliittymäänne painike, joka avaa HMAC-allekirjoitetun syvälinkin https://hostlogic.io/partner/{slug}/activate?token=…. Isäntä valitsee tuotteet, hänen Host Logic -tilinsä otetaan käyttöön, ja 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 — avain on kelvollinen, vastaus sisältää istumapaikkojen käytön
# 401 Unauthorized — avain puuttuu tai on virheellinen
# 403 Forbidden — avain on kelvollinen, mutta vaadittu käyttöoikeus puuttuu
# 429 Too Many Requests — pyyntöraja ylittynyt (120 pyyntöä/min)Kaikki API-pyynnöt edellyttävät Bearer-tunnistetta Authorization-otsakkeessa. Saatte API-avaimenne kumppanihyväksynnän jälkeen kertakäyttöisen paljastuslinkin kautta — selväkielistä avainta ei koskaan tallenneta palvelinpuolelle, eikä sitä voi näyttää uudelleen.
API-avaimissa on etuliite hlk_, ne on rajattu kumppanitilillenne, ja ne voidaan kierrättää ilman käyttökatkoa. Jokaisella avaimella on joukko käyttöoikeuksia, jotka määrittävät, mitä päätepisteitä se voi kutsua. Kunkin avaimen ensimmäiset 12 merkkiä (avaimen etuliite) tallennetaan selväkielisenä lokien tunnistamista varten — loppu on tiivistetty.
https://api.hostlogic.io/partner-api/v1
Sandbox / DEV:https://api-dev.hostlogic.io/partner-api/v1
120 pyyntöä/minuutti API-avainta kohden. Rajoituksen ylitys palauttaa 429 Too Many Requests.
metrics:read — myönnetään aina; kattaa usage-päätepisteen.marcus:read — myönnetään, kun kumppanisopimukseenne sisältyy Marcus (Revenue Manager) -data; kattaa properties- ja pricing-signals-päätepisteet.
| Koodi | Merkitys |
|---|---|
401 | API-avain puuttuu tai on virheellinen |
403 | Avain on kelvollinen, mutta tästä päätepisteestä puuttuva vaadittu käyttöoikeus |
404 | Resurssia ei löytynyt tai se ei kuulu kumppanitilillenne |
429 | Pyyntöjen määrä ylitti rajan — 120 pyyntöä/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"Seuraavat päätepisteet ja integraatiomallit ovat tuotannossa jo nyt. Kaikki tässä luetellut kohteet ovat todellisia ja kutsuttavissa voimassa olevalla API-avaimella.
/usage
Istumapaikkojen käyttö kumppanitilillenne. Laajuus: metrics:read (myönnetään aina). Katso täydellinen viite alta.
/properties
Luettelee sponsoroituihin majoittajiinne kuuluvat majoituspaikat. Laajuus: marcus:read. Katso täydellinen viite alta.
/properties/{propertyId}/pricing-signals
Marcusin hinnoittelusignaalit ja tuleva käyttöaste sponsoroidulle majoituspaikalle. Laajuus: marcus:read. Katso täydellinen viite alta.
Kumppanin aktivointisyvälinkki
HMAC-allekirjoitettu URL-osoite, joka luo sponsoroidun majoittajatilin. Upotetaan käyttöliittymäänne painikkeena. Katso täydellinen viite alta.
Palauttaa todennetun kumppanin aktiivisten istumapaikkojen määrän sekä erittelyn majoittajakohtaisesti. Hyödyllinen laskutuksen täsmäyttämiseen tai käyttökoontinäytön rakentamiseen alustallenne.
metrics:read — myönnetään aina kaikille kumppaniavaimille.
Tämä päätepiste palauttaa tietoja vain todennetulle kumppanille. Se ei koskaan hyväksy partner_id-kyselyparametria — identiteetti tulee kokonaan API-avaimestanne.
Erittely käyttää peitettyjä majoittajakohtaisia käyttäjätunnuksia ja istumapaikkamääriä. Majoittajien sähköpostiosoitteet on tarkoituksella jätetty pois.
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 }
]
}Palauttaa kaikki majoituspaikat, jotka kuuluvat majoittajille, joita kumppanitilinne sponsoroi. Käyttäkää tätä selvittääksenne, mistä majoituspaikoista voitte hakea hinnoittelusignaaleja.
marcus:read — myönnetään, kun kumppanisopimukseenne sisältyy Marcus Revenue Managerin datataso.
Jokainen merkintä sisältää sisäisen majoituspaikan id-tunnuksen (tarvitaan pricing-signals-päätepistettä varten) sekä majoituspaikan name-nimen. Majoittajan henkilötiedot majoituspaikan nimeä lukuun ottamatta on jätetty pois.
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" }
]
}Palauttaa Marcusin hinnoittelusignaalit ja tulevan käyttöasteen yhdelle sponsoroidulle majoituspaikalle. Käyttäkää GET /properties-kutsun palauttamia majoituspaikan id-arvoja. 404 palautetaan, jos majoituspaikkaa ei löydy tai se ei kuulu kumppanitilillenne.
marcus:read
lookback_days (kokonaisluku, oletus 90) — varaushistorian aikajakso, jota käytetään signaalien laskemiseen.
signals-objekti sisältää hinnoitteluindikaattorit ja varaustilastot. Tarkka kenttäjoukko voi kehittyä, kun Marcus lisää uusia tietolähteitä. Alla oleva esimerkkitapaus näyttää julkaisussa saatavilla olevat kentät — käsitelkää mahdollisia tunnistamattomia kenttiä lisäyksinä.
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-kutsun sijaan kumppanin sponsoroimat isännät otetaan käyttöön allekirjoitetun syvälinkin kautta. Isäntä napsauttaa linkkiä, siirtyy maksuttomaan markkinapaikkaan, jossa hän valitsee tuotteet, ja hänen Host Logic -tilinsä luodaan — sponsorointina ja ilman erillistä maksua.
https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>
Missä {slug} on kumppanitilinne yksilöllinen tunniste (annettu käyttöönoton yhteydessä) ja token on HMAC-allekirjoitettu, lyhytikäinen hyötykuorma, joka sisältää isännän identiteettivaatimuksia.
Tokenit allekirjoitetaan HMAC-SHA256:lla käyttäen kumppaninne signing_secret-avainta (erillinen API-avaimesta). Muoto on:
<base64url-payload>.<sha256-hmac>
Hyötykuorma sisältää isännän identiteettivaatimuksia, palvelinpuolen vanhenemisajan (exp) sekä satunnaisen kertakäyttöarvon tokenin uudelleenkäytön estämiseksi.
Oletus: 1 tunti. Vanhentuneet tokenit hylätään selkeällä virheilmoituksella — isäntien on pyydettävä uusi linkki. Host Logic suosittelee linkkien luomista tarpeen mukaan (esim. kun isäntä napsauttaa painiketta käyttöliittymässänne) niiden tallentamisen sijaan.
Tällä hetkellä Host Logic luo aktivointitokenit pyynnöstä hallintatyökalulla. Kumppanin itsepalveluna tekemä tokenien luonti (tokenien ohjelmallinen generointi omasta taustajärjestelmästänne) on Roadmapissa — katso alta.
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"
}| Vaihe | Mitä tapahtuu |
|---|---|
| 1. Token vahvistettu | Host Logic validoi HMAC-allekirjoituksen ja tarkistaa vanhenemisen. Virheelliset tai vanhentuneet tokenit näyttävät selkeän virhesivun. |
| 2. Markkinapaikka | Isäntä siirtyy kumppanisopimukseenne rajattuun maksuttomaan tuote-markkinapaikkaan. Hän valitsee, mitkä tuotteet aktivoidaan. |
| 3. Tili luotu | Sponsoroitu Host Logic -isäntätili luodaan (tai yhdistetään, jos sähköpostiosoite on jo olemassa). Tuotteet aktivoidaan ilman maksuvaihetta. |
| 4. Käyttöönotto | Isäntä ohjataan Laura:n tietopohjaohjatun avustajan läpi (sisäänkirjautumisohjeet, usein kysytyt kysymykset, lisämyyntitarjoukset). Laura alkaa vastata vieraille, kun avustaja on lähetetty. |
Seuraavat ominaisuudet on suunniteltu tai ne ovat kehitteillä. Ne on listattu tässä läpinäkyvyyden vuoksi, jotta voitte suunnitella integraatioroadmapinne. Yksikään näistä ei ole vielä kutsuttavissa — niiden rakentaminen nyt johtaa virheisiin.
Kumppanin itsepalveluna tekemä tokenien luonti
API-päätepiste tai ladattava SDK-koodinpätkä, jonka avulla taustajärjestelmänne voi luoda allekirjoitettuja aktivointitokeneita ilman Host Logicia. Tällä hetkellä tokenit luodaan pyynnöstä hallintatyökalulla.
Kirjoitusoikeudet & muokkaavat päätepisteet
Oikeudet kuten marcus:write ja pierre:write sekä REST-päätepisteet kohteiden rekisteröintiin (POST /properties), yksittäisten yksiköiden aktivointiin tai deaktivointiin sekä kumppaniasetusten päivittämiseen.
Webhookit / reaaliaikaiset tapahtumat
Push-ilmoitukset käyttöönoton valmistumisesta, yksikön aktivoinnista/deaktivoinnista sekä käyttörajojen ylittymisestä. Rekisteröikää webhook-URL ja vastaanottakaa allekirjoitetut hyötykuormat.
Kumppanin itsepalveluportaali
Lippujen avulla ohjattu itsepalveluportaali API-avainten hallintaan, paikkakäytön tarkasteluun ja sallittujen upotussivustojen määrittämiseen. Tällä hetkellä yksityisessä betassa.
Pierre-huolto-rajapinta
GET /properties/{propertyId}/operational-state — sponsoroidun majoituskohteen huolto- ja toimintatila. Toteutettu, mutta poistettu käytöstä ominaisuuslipulla; edellyttää pierre:read-oikeutta. Saatavilla valituille kumppaneille pyynnöstä.
Käyttöönoton iframe-upotus
Upottakaa Laura-määritystoiminto iframe-kehyksenä PMS-käyttöliittymäänne, ja käyttäkää postMessage-tapahtumia vaiheen etenemisen ja valmistumisen ilmoittamiseen. Riippuu kumppanin itsepalveluportaalin julkaisusta.
Isännöity MCP-palvelin yritysasiakkaille
Isännöity MCP-päätepiste osoitteessa mcp.hostlogic.io, joka tarjoaa Claude Desktopin / Cursorin työkalukäytön kumppanikohtaisiin tietoihin. Arkkitehtuuri on suunnitteilla; ei vielä käytössä yrityskumppaneille.
Yrityskumppaneilla on oma Slack-kanava Host Logic -tiimin kanssa. Ottakaa yhteyttä osoitteessa [email protected] keskustellaksenne integraatiovaatimuksistanne ja aikataulustanne.
Kertokaa meille PMS-järjestelmästänne, channel manageristanne tai majoitusalan ohjelmistotuotteestanne. Arvioimme kumppanuushakemukset 2 arkipäivän kuluessa ja toimitamme API-avaimenne sekä oman tukikanavan.