Hurtig start

Tre trin til at gå live

Få din API-nøgle → læs sædeforbrug og prissignaler → indlejr værtens aktiveringslink i dit UI. Det er hele integrationsforløbet, som er tilgængeligt i dag.

Step 1 Få din API-nøgle

Bliv partner. Når du er godkendt, opretter Host Logic din partnerkonto og sender dig et engangs-link til visning, som indeholder din hlk_ API-nøgle. Opbevar den sikkert — den kan ikke vises igen efter visning.

Step 2 Læs forbrug & prissignaler

Kald GET /partner-api/v1/usage for at overvåge sædeforbruget, og GET /partner-api/v1/properties/{id}/pricing-signals for at vise Marcus-prisdata i din platform.

Step 3 Indlejr aktiveringslinket

Tilføj en knap i dit UI, som åbner det HMAC-signede deeplink https://hostlogic.io/partner/{slug}/activate?token=…. Værten vælger produkter, deres Host Logic-konto oprettes, og Laura er klar.

GET /partner-api/v1/usage Kontrollér, at din nøgle virker

curl https://api.hostlogic.io/partner-api/v1/usage \
  -H "Authorization: Bearer hlk_your_key_here" \
  -H "Accept: application/json"

# 200 OK — nøgle er gyldig, svaret indeholder dit sædeforbrug
# 401 Unauthorized — nøgle mangler eller er ugyldig
# 403 Forbidden — nøgle er gyldig, men mangler det krævede scope
# 429 Too Many Requests — hastighedsbegrænsning (120 req/min)

Autentificering

API-nøgleautentificering

Alle API-anmodninger kræver et Bearer-token i Authorization-headeren. Du modtager din API-nøgle efter partnergodkendelse via et engangs-link til visning — den rå nøgle gemmes aldrig på serversiden og kan ikke vises igen.

API-nøgler har præfikset hlk_, er knyttet til din partnerkonto og kan roteres uden nedetid. Hver nøgle har et sæt scopes, der styrer, hvilke endpoints den må kalde. De første 12 tegn af hver nøgle (nøglepræfikset) gemmes i klartekst til identifikation i logs — resten hashes.

Base-URL'er https://api.hostlogic.io/partner-api/v1

Sandbox / DEV:
https://api-dev.hostlogic.io/partner-api/v1

Hastighedsbegrænsning

120 anmodninger/minut pr. API-nøgle. Ved overskridelse returneres 429 Too Many Requests.

Scopes

metrics:read — gives altid; dækker usage-endpointet.
marcus:read — gives, når din partneraftale inkluderer Marcus-data (Revenue Manager); dækker endpointsene properties og pricing-signals.

Fejlkoder

Kode	Betydning
`401`	API-nøgle mangler eller er ugyldig
`403`	Nøglen er gyldig, men mangler det krævede scope til dette endpoint
`404`	Ressource ikke fundet, eller ikke ejet af din partnerkonto
`429`	Ratelimit overskredet — 120 req/min

Hver anmodning — foretrukken header

curl https://api.hostlogic.io/partner-api/v1/usage \
  -H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
  -H "Accept: application/json"

Alternativ header (CLI-bekvemmelighed)

curl https://api.hostlogic.io/partner-api/v1/usage \
  -H "X-Enterprise-Key: hlk_a8f3c2e1b4d5..." \
  -H "Accept: application/json"

Tilgængelig nu

Live-endpoints og funktioner

Følgende endpoints og integrationsmønstre er i drift i dag. Alt, der er listet her, er reelt og kan kaldes med en gyldig API-nøgle.

GET /usage

Sædeforbrug for din partnerkonto. Scope: metrics:read (tildeles altid). Se fuld reference nedenfor.

GET /properties

Vis ejendomme, der tilhører dine sponsorerede værter. Scope: marcus:read. Se fuld reference nedenfor.

GET /properties/{propertyId}/pricing-signals

Marcus-prissignaler og kommende belægning for en sponsoreret ejendom. Scope: marcus:read. Se fuld reference nedenfor.

LINK Deep-link til partneraktivering

HMAC-signeret URL, der opretter en sponsoreret værtkonto. Indlejret i dit UI som en knap. Se fuld reference nedenfor.

Forbrugs-endpoint

GET /usage — Sædeforbrug

Returnerer den autentificerede partners aktive sædeantal med en opdeling pr. vært. Nyttigt til afstemning af fakturering eller til at bygge et forbrugsdashboard i din platform.

Påkrævet scope

metrics:read — tildeles altid til alle partnernøgler.

IDOR-beskyttelse

Dette endpoint returnerer kun data for den autentificerede partner. Det accepterer aldrig en partner_id-forespørgselsparameter — identiteten kommer udelukkende fra din API-nøgle.

Minimering af persondata

Opdelingen bruger uigennemsigtige værtbruger-ID'er og sædeantal. Værters e-mailadresser er bevidst udeladt.

Anmodning

curl https://api.hostlogic.io/partner-api/v1/usage \
  -H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
  -H "Accept: application/json"

Svar

{
  "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 }
  ]
}

Ejendoms-endpoint

GET /properties — Liste over sponsorerede ejendomme

Returnerer alle ejendomme, der tilhører værter, som din partnerkonto sponsorerer. Brug dette til at finde ud af, hvilke ejendomme du kan forespørge for prissignaler.

Påkrævet scope

marcus:read — tildeles, når din partneraftale inkluderer Marcus Revenue Manager-dataområdet.

Returnerede data

Hver post indeholder den interne ejendoms id (nødvendig for pricing-signals-endpointet) og ejendommens name. Værtens persondata ud over ejendomsnavnet er udeladt.

Anmodning

curl https://api.hostlogic.io/partner-api/v1/properties \
  -H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
  -H "Accept: application/json"

Svar

{
  "partner_id": 1,
  "generated_at": "2026-06-01T10:30:00Z",
  "properties": [
    { "id": 12, "name": "Harbour View Apartment" },
    { "id": 17, "name": "Old Town Studio" }
  ]
}

Endpoint for prissignaler

GET /properties/{propertyId}/pricing-signals

Returnerer Marcus-prissignaler og kommende belægning for en enkelt sponsoreret ejendom. Brug ejendommens id-værdier, der returneres af GET /properties. Der returneres en 404, hvis ejendommen ikke findes eller ikke ejes af din partnerkonto.

Påkrævet scope

marcus:read

Forespørgselsparameter

lookback_days (heltal, standard 90) — reservationshistorik-vindue, der bruges til at beregne signaler.

Bemærkning om svarstruktur

signals-objektet indeholder prisindikatorer og reservationsstatistik. Det præcise sæt felter kan udvikle sig, efterhånden som Marcus tilføjer nye datakilder. Eksemplet nedenfor viser de felter, der er tilgængelige ved lancering — behandl eventuelle ukendte felter som tillæg.

Anmodning

curl "https://api.hostlogic.io/partner-api/v1/properties/12/pricing-signals?lookback_days=90" \
  -H "Authorization: Bearer hlk_a8f3c2e1b4d5..." \
  -H "Accept: application/json"

Eksempel på svar (felter kan ændre sig)

{
  "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
  }
}

Host-aktivering

Partneraktivering via deep-link

I stedet for et REST-kald onboardes hosts, der er sponsoreret af en partner, via et signeret deep-link. Værten klikker på det, lander på en markedsplads uden priser, hvor vedkommende vælger produkter, og dennes Host Logic-konto oprettes — sponsoreret og uden separat betaling.

Linkformat

URL-mønster https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>

Hvor {slug} er den unikke identifikator for din partnerkonto (oplyst ved onboarding), og token er en HMAC-signeret payload med kort levetid, der indeholder claims om værtens identitet.

Tokensikkerhed

Tokens signeres med HMAC-SHA256 ved hjælp af din partners signing_secret (adskilt fra din API-nøgle). Formatet er:

<base64url-payload>.<sha256-hmac>

Payloaden indeholder claims om værtens identitet, et udløbstidspunkt på serversiden (exp) og en tilfældig nonce for at forhindre genbrug af tokenet.

Tokenets levetid

Standard: 1 time. Udløbne tokens afvises med en tydelig fejl — værter skal anmode om et nyt link. Host Logic anbefaler at generere links efter behov (f.eks. når en vært klikker på en knap i dit UI) frem for at gemme dem.

I dag vs. Roadmap

I dag genereres aktiveringstokens via et adminværktøj af Host Logic efter anmodning. Partnerens selvbetjente token-minting (generering af tokens programmatisk fra din egen backend) er på Roadmap — se nedenfor.

Eksempel på deep-link

https://hostlogic.io/partner/previo/activate
  ?token=eyJjb250YWN0X2VtYWlsIjoiaG9zdEBleGFtcGxlLmNvbSIsImV4cCI6MTc1MDAwMDAwMCwibm9uY2UiOiJhYjEyY2QzNCJ9.a1b2c3d4e5f6...

Indlejring i dit UI

<!-- Simple button — opens in a new tab -->
<a href="{{ $activationUrl }}" target="_blank" class="btn">
  Set up AI Receptionist →
</a>

Claims i token-payloaden (illustrativt)

{
  "contact_email": "[email protected]",
  "contact_name": "Hotel Adriatic",
  "previo_hotel_id": "779307",
  "requested_product_ids": ["laura-receptionist"],
  "exp": 1750000000,
  "nonce": "ab12cd34"
}

Værtens oplevelse efter klik

Trin	Hvad der sker
1. Token verificeret	Host Logic validerer HMAC-signaturen og kontrollerer udløbstiden. Ugyldige eller udløbne tokens viser en tydelig fejlside.
2. Markedsplads	Værten lander på en produktmarkedsplads uden priser, som er afgrænset til din partneraftale. Vedkommende vælger, hvilke produkter der skal aktiveres.
3. Konto oprettet	Der oprettes en sponsoreret Host Logic-værtskonto (eller den tilknyttes, hvis e-mailen allerede findes). Produkterne aktiveres uden betalingstrin.
4. Onboarding	Værten guides gennem Lauras vidensbase-wizard (indcheckningsinstruktioner, FAQ, mersalgstilbud). Laura begynder at besvare gæster, når wizard'en er indsendt.

Roadmap

Kommer snart

Følgende funktioner er planlagt eller under udvikling. Du er listet her for gennemsigtighed, så du kan planlægge din integrations-roadmap. Ingen af disse kan kaldes i dag — hvis du bygger mod dem nu, vil det resultere i fejl.

ROADMAP Partnerens selvbetjente token-minting

Et API-endpoint eller et downloadbart SDK-udsnit, der lader din backend generere signerede aktiveringstokens uden involvering af Host Logic. I dag genereres tokens efter anmodning via et adminværktøj.

ROADMAP Write-scopes & muterende endpoints

Scopes såsom marcus:write og pierre:write samt REST-endpoints til at registrere ejendomme (POST /properties), aktivere eller deaktivere enkelte enheder og opdatere partnerindstillinger.

ROADMAP Webhooks / realtidsbegivenheder

Push-notifikationer for onboarding fuldført, enhed aktiveret/deaktiveret og forbrugsgrænser. Registrer en webhook-URL og modtag signerede payloads.

ROADMAP Partnerens selvbetjente portal

En flagstyret selvbetjeningsportal til håndtering af API-nøgler, visning af sædeforbrug og konfiguration af tilladte embed-origins. Lige nu i privat beta.

PRIVATE BETA Pierre vedligeholdelses-endpoint

GET /properties/{propertyId}/operational-state — vedligeholdelses- og driftsstatus for en sponsoreret ejendom. Er bygget, men deaktiveret via en feature flag; kræver pierre:read-scope. Tilgængelig for udvalgte partnere efter anmodning.

ROADMAP Onboarding-iframe-indsætning

Indsæt Laura-konfigurationsguiden som en iframe i din PMS-brugerflade, med postMessage-events til fremdrift i trin og fuldførelse. Afhænger af lanceringen af partnerens selvbetjeningsportal.

ROADMAP Hostet MCP-server til enterprise

Et hostet MCP-endpoint på mcp.hostlogic.io, der giver Claude Desktop / Cursor adgang til værktøjer og partnerafgrænsede data. Arkitekturen er planlagt; er endnu ikke live for enterprise-partnere.

Ønsker du tidlig adgang eller indflydelse på roadmap-prioriteter?

Enterprise-partnere har en dedikeret Slack-kanal med Host Logic-teamet. Kontakt os på [email protected] for at drøfte dit integrationskrav og tidsplan.

AI-infrastrukturen
der driver moderne hospitality-platforme

Tre trin til at gå live

API-nøgleautentificering

Fejlkoder

Live-endpoints og funktioner

GET /usage — Sædeforbrug

GET /properties — Liste over sponsorerede ejendomme

GET /properties/{propertyId}/pricing-signals

Partneraktivering via deep-link

Linkformat

Tokensikkerhed

Værtens oplevelse efter klik

Kommer snart

Ønsker du at bringe Host Logic-agenter til din platform?

AI-infrastrukturender driver moderne hospitality-platforme

Tre trin til at gå live

API-nøgleautentificering

Fejlkoder

Live-endpoints og funktioner

GET /usage — Sædeforbrug

GET /properties — Liste over sponsorerede ejendomme

GET /properties/{propertyId}/pricing-signals

Partneraktivering via deep-link

Linkformat

Tokensikkerhed

Værtens oplevelse efter klik

Kommer snart

Ønsker du at bringe Host Logic-agenter til din platform?

AI-infrastrukturen
der driver moderne hospitality-platforme