Geliştiriciler için
Sitenizi Trimango'ya bağlamak için gereken her şey: Site API, webhook, partner embed ve tm.js.
Kimlik
Her istek istemci kimliğiyle gelir. İstemciyi Trimango ekibi platform konsolunda açar; gizli anahtar yalnız oluştururken bir kez görünür.
- Authorization: Basic base64(client_id:client_secret)
- Anahtar tarayıcıya inmez; bütün çağrılar sitenizin sunucusundan yapılır
- Bağlantı denemesi: GET /site firma adını döner
GET /api/public/v1/site
Authorization: Basic <client_id:client_secret>
200 OK
{ "name": "Ege Tatil Evleri", "api_version": "1", … }Hız sınırı ve önbellek
İstemci başına dakikada 1.200 istek. GET yanıtları ETag taşır; değişmeyen yanıt 304 döner.
- Sınır aşılırsa 429 ve Retry-After
- If-None-Match ile koşullu istek
- Ziyaretçinin IP'si X-Visitor-IP başlığıyla iletilir
Uçlar
Sitenin her ekranı için bir uç ailesi var.
- Katalog, villa detayı ve takvim
- Fiyat teklifi ve toplu teklif
- İçerik, SEO ve yönlendirmeler
- Rezervasyon talebi, sorgulama ve ödeme
- Misafir girişi (telefon ve kod) ve "Rezervasyonlarım"
- Yorumlar, favoriler ve fiyat izleme
- "Anlat, bulalım" ve "Bu villaya sor"
- Görüşme kodu, görüntülü görüşme randevusu, kısa link
Webhook
Fiyat, müsaitlik, villa ya da içerik değişince sitenize imzalı bir bildirim gelir; önbelleği yenilersiniz.
- Olaylar: availability, price, villa, content, reference
- HMAC-SHA256 imzalı, zaman damgası imzaya dahil; değişiklikler 5 saniye toplanıp gönderilir
- Konsolda gönderim geçmişi ve "Yeniden gönder"
POST https://siteniz.com/api/trimango/revalidate
X-Trimango-Event-Type: availability
X-Trimango-Timestamp: 1760518800
X-Trimango-Signature: sha256=5d41…
{ "type": "availability", "villas": [ { "slug": "villa-defne" } ] }Partner embed ve tm.js
Partnerlerinize iframe ile gömülen, çerezsiz sayfalar verin. tm.js sitenize tek satırla eklenir ve ziyaretçinin onayıyla çalışır.
- Embed sayfaları ayrı bir izleme anahtarıyla ölçülür
- tm.js olayları sitenizin /tm/* yolundan Trimango'ya iletilir
- Onay yoksa tarayıcı hiçbir olay göndermez
Bağlantı rehberi ve test istemcisi için demo formundan bize yazın.
Bunu kendi işinizde görün
Trimango'yu sizin villalarınız ve ekibinizle birlikte gösterelim.