API de données en lecture seule et deep-link d’activation partenaire pour intégrer les agents IA de Host Logic à votre PMS ou à votre plateforme de gestion immobilière. Cette page documente uniquement ce qui est disponible aujourd’hui — une section Feuille de route clairement identifiée couvre ce qui arrive ensuite.
Obtenez votre clé API → consultez l’utilisation des sièges et les signaux tarifaires → intégrez le lien d’activation de l’hôte dans votre interface. C’est le flux d’intégration complet disponible aujourd’hui.
Obtenez votre clé API
Devenez partenaire. Une fois votre demande approuvée, Host Logic crée votre compte partenaire et vous envoie un lien de révélation à usage unique contenant votre clé API hlk_. Conservez-la en lieu sûr — elle ne pourra plus être affichée après révélation.
Consultez l’utilisation et les signaux tarifaires
Appelez GET /partner-api/v1/usage pour suivre la consommation des sièges, et GET /partner-api/v1/properties/{id}/pricing-signals pour afficher les données tarifaires Marcus dans votre plateforme.
Intégrez le lien d’activation
Ajoutez un bouton dans votre interface qui ouvre le deep-link signé HMAC https://hostlogic.io/partner/{slug}/activate?token=…. L’hôte choisit les produits, son compte Host Logic est provisionné, et Laura est prête.
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_your_key_here" \
-H "Accept: application/json"
# 200 OK — la clé est valide, la réponse contient l’utilisation de vos sièges
# 401 Unauthorized — clé manquante ou invalide
# 403 Forbidden — clé valide, mais portée requise manquante
# 429 Too Many Requests — limite de débit (120 requêtes/min)Toutes les requêtes API nécessitent un jeton Bearer dans l’en-tête Authorization. Vous recevez votre clé API après l’approbation du partenariat via un lien de révélation à usage unique — la clé en clair n’est jamais stockée côté serveur et ne peut pas être réaffichée.
Les clés API sont préfixées par hlk_, sont associées à votre compte partenaire et peuvent être renouvelées sans interruption de service. Chaque clé comporte un ensemble de portées qui déterminent les endpoints qu’elle peut appeler. Les 12 premiers caractères de chaque clé (le préfixe de la clé) sont stockés en clair pour l’identification dans les journaux — le reste est haché.
https://api.hostlogic.io/partner-api/v1
Sandbox / DEV :https://api-dev.hostlogic.io/partner-api/v1
120 requêtes/minute par clé API. Tout dépassement renvoie 429 Too Many Requests.
metrics:read — toujours accordée ; couvre l’endpoint d’utilisation.marcus:read — accordée lorsque votre contrat partenaire inclut les données Marcus (Revenue Manager) ; couvre les endpoints properties et pricing-signals.
| Code | Signification |
|---|---|
401 | Clé API manquante ou invalide |
403 | Clé valide, mais portée requise pour cet endpoint manquante |
404 | Ressource introuvable, ou n’appartenant pas à votre compte partenaire |
429 | Limite de débit dépassée — 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"Les endpoints et modèles d’intégration suivants sont déjà en production. Tout ce qui est listé ici est réel et appelable avec une clé API valide.
/usage
Utilisation des sièges pour votre compte partenaire. Portée : metrics:read (toujours accordée). Voir la référence complète ci-dessous.
/properties
Liste des propriétés appartenant à vos hôtes sponsorisés. Portée : marcus:read. Voir la référence complète ci-dessous.
/properties/{propertyId}/pricing-signals
Signaux tarifaires Marcus et occupation à venir pour une propriété sponsorisée. Portée : marcus:read. Voir la référence complète ci-dessous.
Lien profond d’activation partenaire
URL signée HMAC qui provisionne un compte d’hôte sponsorisé. Intégrée dans votre interface sous forme de bouton. Voir la référence complète ci-dessous.
Renvoie le nombre de sièges actifs du partenaire authentifié, avec une répartition par hôte. Utile pour rapprocher la facturation ou créer un tableau de bord d’utilisation dans votre plateforme.
metrics:read — toujours accordée à toutes les clés partenaires.
Cet endpoint ne renvoie des données que pour le partenaire authentifié. Il n’accepte jamais de paramètre de requête partner_id — l’identité provient entièrement de votre clé API.
La répartition utilise des identifiants d’hôte opaques et des nombres de sièges. Les e-mails des hôtes sont volontairement exclus.
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 }
]
}Renvoie toutes les propriétés appartenant aux hôtes que votre compte partenaire sponsorise. Utilisez-le pour découvrir quelles propriétés vous pouvez interroger pour obtenir des signaux tarifaires.
marcus:read — accordée lorsque votre contrat partenaire inclut le data plane de Marcus Revenue Manager.
Chaque entrée contient l’id interne de la propriété (nécessaire pour l’endpoint pricing-signals) et le name de la propriété. Les données personnelles de l’hôte, au-delà du nom de la propriété, sont exclues.
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" }
]
}Renvoie les signaux tarifaires Marcus et l’occupation à venir pour une seule propriété sponsorisée. Utilisez les valeurs id des propriétés renvoyées par GET /properties. Un 404 est renvoyé si la propriété est introuvable ou n’appartient pas à votre compte partenaire.
marcus:read
lookback_days (entier, valeur par défaut 90) — fenêtre d’historique des réservations utilisée pour calculer les signaux.
L’objet signals contient des indicateurs tarifaires et des statistiques de réservation. L’ensemble exact des champs peut évoluer à mesure que Marcus ajoute de nouvelles sources de données. L’exemple représentatif ci-dessous montre les champs disponibles au lancement — considérez tout champ non reconnu comme un ajout.
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
}
}Au lieu d’un appel REST, les hôtes sponsorisés par un partenaire sont intégrés via un lien profond signé. L’hôte clique dessus, arrive sur une place de marché sans tarification où il choisit ses produits, puis son compte Host Logic est provisionné — sponsorisé et sans paiement séparé requis.
https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>
Où {slug} est l’identifiant unique de votre compte partenaire (fourni lors de l’onboarding) et token est une charge utile signée en HMAC, à durée de vie courte, contenant des revendications d’identité de l’hôte.
Les jetons sont signés avec HMAC-SHA256 à l’aide du signing_secret de votre partenaire (distinct de votre clé API). Le format est le suivant :
<base64url-payload>.<sha256-hmac>
La charge utile contient des revendications d’identité de l’hôte, un horodatage d’expiration côté serveur (exp) et un nonce aléatoire afin d’empêcher la réutilisation du jeton.
Par défaut : 1 heure. Les jetons expirés sont rejetés avec un message d’erreur clair — les hôtes doivent demander un nouveau lien. Host Logic recommande de générer les liens à la demande (par exemple lorsqu’un hôte clique sur un bouton dans votre interface) plutôt que de les stocker.
Aujourd’hui, les jetons d’activation sont générés à la demande par Host Logic via un outil d’administration. La génération de jetons en libre-service par le partenaire (génération programmatique depuis votre propre backend) figure sur la feuille de route — voir ci-dessous.
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"
}| Étape | Ce qui se passe |
|---|---|
| 1. Jeton vérifié | Host Logic valide la signature HMAC et vérifie l’expiration. Les jetons invalides ou expirés affichent une page d’erreur claire. |
| 2. Place de marché | L’hôte arrive sur une place de marché de produits sans tarification, limitée à votre accord partenaire. Il sélectionne les produits à activer. |
| 3. Compte provisionné | Un compte hôte Host Logic sponsorisé est créé (ou associé si l’adresse e-mail existe déjà). Les produits sont activés sans étape de paiement. |
| 4. Onboarding | L’hôte est guidé par l’assistant de base de connaissances de Laura (instructions d’arrivée, FAQ, offres de vente additionnelle). Laura commence à répondre aux invités une fois l’assistant validé. |
Les fonctionnalités suivantes sont prévues ou en cours de développement. Elles sont listées ici à titre de transparence afin que vous puissiez planifier votre feuille de route d’intégration. Aucune d’entre elles n’est disponible à l’appel aujourd’hui — développer en s’appuyant dessus entraînera des erreurs.
Génération de jetons en libre-service par le partenaire
Un point de terminaison API ou un extrait SDK téléchargeable permettant à votre backend de générer des jetons d’activation signés sans intervention de Host Logic. Aujourd’hui, les jetons sont générés à la demande via un outil d’administration.
Scopes d’écriture et points de terminaison de modification
Des scopes tels que marcus:write et pierre:write, ainsi que des points de terminaison REST pour enregistrer des établissements (POST /properties), activer ou désactiver des unités individuelles et mettre à jour les paramètres du partenaire.
Webhooks / événements en temps réel
Notifications push pour l’onboarding terminé, l’activation/désactivation d’une unité et les seuils d’utilisation. Enregistrez une URL de webhook et recevez des charges utiles signées.
Portail partenaire en libre-service
Un portail en libre-service activé par drapeau pour gérer les clés API, consulter l’utilisation des sièges et configurer les origines d’intégration autorisées. Actuellement en bêta privée.
Point de terminaison de maintenance Pierre
GET /properties/{propertyId}/operational-state — état de maintenance et état opérationnel d’un établissement sponsorisé. Développé mais désactivé par un feature flag ; nécessite le scope pierre:read. Disponible pour certains partenaires sur demande.
Intégration de l’onboarding en iframe
Intégrez l’assistant de configuration Laura en tant qu’iframe dans l’interface de votre PMS, avec des événements postMessage pour le suivi des étapes et la finalisation. Dépend du lancement du portail self-service partenaire.
Serveur MCP hébergé pour les entreprises
Un endpoint MCP hébergé sur mcp.hostlogic.io offrant un accès aux outils Claude Desktop / Cursor aux données limitées au partenaire. Architecture prévue ; pas encore en ligne pour les partenaires enterprise.
Les partenaires enterprise disposent d’un canal Slack dédié avec l’équipe Host Logic. Contactez-nous à l’adresse [email protected] pour discuter de vos besoins d’intégration et de votre calendrier.
Parlez-nous de votre PMS, de votre channel manager ou de votre logiciel hôtelier. Nous examinons les demandes de partenariat sous 2 jours ouvrés et vous fournissons votre clé API ainsi qu’un canal d’assistance dédié.