Host Logic’in yapay zekâ ajanlarını PMS’nize veya mülk yönetim platformunuza entegre etmek için salt okunur veri API’sini ve partner aktivasyon derin bağlantısını kullanın. Bu sayfa yalnızca bugün canlı olanları belgeler — açıkça etiketlenmiş Roadmap bölümü, sırada ne olduğunu kapsar.
API anahtarınızı alın → koltuk kullanımını ve fiyatlandırma sinyallerini okuyun → host aktivasyon bağlantısını arayüzünüze gömün. Bugün mevcut olan tam entegrasyon akışı budur.
API anahtarınızı alın
Partner olun. Onaylandıktan sonra Host Logic partner hesabınızı oluşturur ve size hlk_ API anahtarınızı içeren tek kullanımlık bir gösterim bağlantısı gönderir. Güvenli şekilde saklayın — bir kez gösterildikten sonra tekrar görüntülenemez.
Kullanım ve fiyatlandırma sinyallerini okuyun
Koltuk tüketimini izlemek için GET /partner-api/v1/usage çağrısını yapın ve platformunuz içinde Marcus fiyatlandırma verilerini göstermek için GET /partner-api/v1/properties/{id}/pricing-signals çağrısını kullanın.
Aktivasyon bağlantısını gömün
Arayüzünüze, HMAC ile imzalanmış derin bağlantıyı açan bir düğme ekleyin: https://hostlogic.io/partner/{slug}/activate?token=…. Host ürünleri seçer, Host Logic hesabı sağlanır ve Laura kullanıma hazır olur.
curl https://api.hostlogic.io/partner-api/v1/usage \
-H "Authorization: Bearer hlk_your_key_here" \
-H "Accept: application/json"
# 200 OK — anahtar geçerli, yanıt koltuk kullanımınızı içerir
# 401 Unauthorized — anahtar eksik veya geçersiz
# 403 Forbidden — anahtar geçerli ancak gerekli kapsam eksik
# 429 Too Many Requests — hız limiti (120 istek/dk)Tüm API istekleri, Authorization başlığında bir Bearer token gerektirir. API anahtarınızı partner onayından sonra tek kullanımlık bir gösterim bağlantısı üzerinden alırsınız — düz anahtar sunucu tarafında asla saklanmaz ve tekrar gösterilemez.
API anahtarları hlk_ önekiyle başlar, partner hesabınıza özeldir ve kesinti olmadan döndürülebilir. Her anahtar, hangi uç noktaları çağırabileceğini belirleyen bir kapsam seti içerir. Her anahtarın ilk 12 karakteri (anahtar öneki), günlüklerde tanımlama amacıyla düz metin olarak saklanır — geri kalanı hash’lenir.
https://api.hostlogic.io/partner-api/v1
Sandbox / DEV:https://api-dev.hostlogic.io/partner-api/v1
API anahtarı başına dakikada 120 istek. Aşılması durumunda 429 Too Many Requests döner.
metrics:read — her zaman verilir; kullanım uç noktasını kapsar.marcus:read — partner sözleşmeniz Marcus (Revenue Manager) verilerini içerdiğinde verilir; properties ve pricing-signals uç noktalarını kapsar.
| Kod | Anlamı |
|---|---|
401 | API anahtarı eksik veya geçersiz |
403 | Anahtar geçerli, ancak bu uç nokta için gerekli kapsam eksik |
404 | Kaynak bulunamadı veya ortak hesabınıza ait değil |
429 | İstek limiti aşıldı — 120 istek/dk |
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"Aşağıdaki uç noktalar ve entegrasyon kalıpları bugün üretimde kullanılmaktadır. Burada listelenen her şey gerçektir ve geçerli bir API anahtarıyla çağrılabilir.
/usage
Ortak hesabınız için koltuk kullanımı. Kapsam: metrics:read (her zaman verilir). Ayrıntılı referansa aşağıdan bakın.
/properties
Sponsor olduğunuz hostlara ait mülkleri listeler. Kapsam: marcus:read. Ayrıntılı referansa aşağıdan bakın.
/properties/{propertyId}/pricing-signals
Sponsor olunan bir mülk için Marcus fiyatlandırma sinyalleri ve yaklaşan doluluk. Kapsam: marcus:read. Ayrıntılı referansa aşağıdan bakın.
Ortak aktivasyon derin bağlantısı
Sponsor olunan bir host hesabı oluşturan HMAC imzalı URL. Arayüzünüze bir düğme olarak yerleştirilir. Ayrıntılı referansa aşağıdan bakın.
Kimliği doğrulanmış ortağın aktif koltuk sayısını, host bazında dökümle birlikte döndürür. Faturalandırmayı mutabakatla eşleştirmek veya platformunuz içinde bir kullanım panosu oluşturmak için kullanışlıdır.
metrics:read — tüm ortak anahtarlarına her zaman verilir.
Bu uç nokta yalnızca kimliği doğrulanmış ortağa ait verileri döndürür. Asla bir partner_id sorgu parametresi kabul etmez — kimlik tamamen API anahtarınızdan alınır.
Dökümde belirsiz host kullanıcı kimlikleri ve koltuk sayıları kullanılır. Host e-postaları bilerek hariç tutulur.
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 }
]
}Ortak hesabınızın sponsor olduğu hostlara ait tüm mülkleri döndürür. Bunu, fiyatlandırma sinyalleri için hangi mülkleri sorgulayabileceğinizi keşfetmek için kullanın.
marcus:read — ortak sözleşmenizde Marcus Revenue Manager veri katmanı yer aldığında verilir.
Her kayıt, fiyatlandırma-sinyalleri uç noktası için gerekli olan dahili mülk id değerini ve mülk name bilgisini içerir. Mülk adının ötesindeki host PII bilgileri hariç tutulur.
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" }
]
}Tek bir sponsor olunan mülk için Marcus fiyatlandırma sinyallerini ve yaklaşan doluluğu döndürür. GET /properties tarafından döndürülen mülk id değerlerini kullanın. Mülk bulunamazsa veya ortak hesabınıza ait değilse 404 döndürülür.
marcus:read
lookback_days (tamsayı, varsayılan 90) — sinyalleri hesaplamak için kullanılan rezervasyon geçmişi penceresi.
signals nesnesi fiyatlandırma göstergelerini ve rezervasyon istatistiklerini içerir. Marcus yeni veri kaynakları ekledikçe tam alan kümesi değişebilir. Aşağıdaki örnek, lansmanda उपलब्ध olan alanları gösterir — tanınmayan alanları ek alanlar olarak değerlendirin.
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
}
}Bir REST çağrısı yerine, partner sponsorlu hostlar imzalı bir derin bağlantı üzerinden sisteme alınır. Host bağlantıya tıklar, fiyat bilgisi olmayan bir pazaryerine yönlendirilir, ürünleri seçer ve Host Logic hesabı sponsorlu olarak, ayrıca ayrı bir ödeme gerektirmeden oluşturulur.
https://hostlogic.io/partner/{slug}/activate?token=<hmac-signed-token>
Burada {slug}, partner hesabınızın benzersiz tanımlayıcısıdır (onboarding sırasında sağlanır) ve token, host kimliği beyanlarını taşıyan, HMAC ile imzalanmış, kısa ömürlü bir yükdür.
Tokenlar, API anahtarınızdan ayrı olan partnerinizin signing_secret değeri kullanılarak HMAC-SHA256 ile imzalanır. Biçim şöyledir:
<base64url-payload>.<sha256-hmac>
Yük, host kimliği beyanlarını, sunucu tarafında bir son kullanma zaman damgasını (exp) ve tokenın yeniden kullanılmasını önlemek için rastgele bir nonce içerir.
Varsayılan: 1 saat. Süresi dolmuş tokenlar net bir hata ile reddedilir — hostların yeni bir bağlantı talep etmesi gerekir. Host Logic, bağlantıların saklanması yerine ihtiyaç anında (ör. bir host arayüzünüzdeki bir düğmeye tıkladığında) oluşturulmasını önerir.
Bugün aktivasyon tokenları, talep üzerine Host Logic tarafından bir yönetici aracı üzerinden oluşturulur. Partnerin kendi kendine hizmet token üretimi (kendi arka ucunuzdan programatik olarak token oluşturma) Yol Haritası'ndadır — aşağıya bakın.
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"
}| Adım | Ne olur |
|---|---|
| 1. Token doğrulandı | Host Logic, HMAC imzasını doğrular ve süresini kontrol eder. Geçersiz veya süresi dolmuş tokenlar net bir hata sayfası gösterir. |
| 2. Pazaryeri | Host, partner anlaşmanıza özel, fiyat bilgisi olmayan bir ürün pazaryerine yönlendirilir. Hangi ürünleri etkinleştireceğini seçer. |
| 3. Hesap sağlandı | Sponsorlu bir Host Logic host hesabı oluşturulur (veya e-posta zaten varsa mevcut hesapla ilişkilendirilir). Ürünler ödeme adımı olmadan etkinleştirilir. |
| 4. Onboarding | Host, Laura'nın bilgi tabanı sihirbazı üzerinden yönlendirilir (giriş talimatları, SSS, çapraz satış teklifleri). Sihirbaz gönderildikten sonra Laura misafirlere yanıt vermeye başlar. |
Aşağıdaki özellikler planlanıyor veya geliştirme aşamasında. Entegrasyon yol haritanızı planlayabilmeniz için şeffaflık amacıyla burada listelenmiştir. Bunların hiçbiri bugün çağrılamaz — şu anda bunlara karşı geliştirme yapmak hatalara yol açacaktır.
Partnerin kendi kendine hizmet token üretimi
Arka ucunuzun Host Logic'e ihtiyaç duymadan imzalı aktivasyon tokenları oluşturmasını sağlayan bir API uç noktası veya indirilebilir SDK kod parçası. Bugün tokenlar talep üzerine bir yönetici aracı üzerinden oluşturulur.
Yazma kapsamları & değiştiren uç noktalar
marcus:write ve pierre:write gibi kapsamlar ile mülkleri kaydetmek için REST uç noktaları (POST /properties), tekil birimleri etkinleştirmek veya devre dışı bırakmak ve partner ayarlarını güncellemek.
Webhooklar / gerçek zamanlı olaylar
Onboarding tamamlandı, birim etkinleştirildi/devre dışı bırakıldı ve kullanım eşikleri için anlık bildirimler. Bir webhook URL'si kaydedin ve imzalı yükler alın.
Partnerin kendi kendine hizmet portalı
API anahtarlarını yönetmek, koltuk kullanımını görüntülemek ve izin verilen gömme kaynaklarını yapılandırmak için özellik bayrağıyla açılan bir self-servis portal. Şu anda özel beta aşamasında.
Pierre bakım uç noktası
GET /properties/{propertyId}/operational-state — sponsorlu bir tesis için bakım ve operasyonel durum. Geliştirilmiş ancak bir özellik bayrağıyla devre dışı bırakılmıştır; pierre:read kapsamı gerektirir. Talep üzerine seçili iş ortaklarına sunulur.
Onboarding iframe entegrasyonu
Laura yapılandırma sihirbazını PMS arayüzünüze bir iframe olarak gömün; adım ilerlemesi ve tamamlanma için postMessage etkinlikleri kullanılır. İş ortağı self-servis portalının kullanıma açılmasına bağlıdır.
Kurumsal kullanım için barındırılan MCP sunucusu
mcp.hostlogic.io üzerinde barındırılan bir MCP uç noktası; Claude Desktop / Cursor araç erişimiyle iş ortağı kapsamındaki verilere erişim sağlar. Mimari planlanmıştır; kurumsal iş ortakları için henüz canlı değildir.
Kurumsal iş ortaklarının Host Logic ekibiyle özel bir Slack kanalı vardır. Entegrasyon gereksinimlerinizi ve zaman çizelgenizi görüşmek için [email protected] adresinden bizimle iletişime geçin.
Bize PMS'iniz, channel manager'ınız veya hospitality yazılım ürününüz hakkında bilgi verin. İş ortağı başvurularını 2 iş günü içinde inceliyor, API anahtarınızı ve size özel destek kanalınızı sağlıyoruz.