Kimlik doğrulama ve aktarım
Authorization: Bearer <callback_token> ve User-Agent: SixtoAgent/1.0 gönderin. Belirteçleri URL’lere, günlüklere ve model konuşma dökümlerine koymayın. reads_url değerini iletildiği gibi kullanın; çalıştırmayı zaten tanımlar. Normal, kapsamı sınırlı bir API anahtarı geri çağırma belirteci değildir. İmzalı aktarım, bu bearer örneği yerine kendi yetkisini ve HTTP imza protokolünü kullanır.
Görüntü ve dosya baytları webhook gövdesinde yer almaz. Paketteki her görüntü veya dosyanın kısa ömürlü bir url adresi vardır (yaklaşık 20 dakika veya çalıştırma bitene kadar). Geri çağırma belirteciyle GET isteği göndererek alın. Bağlantı yalnızca o çalıştırmanın ileti dizisi, görevi veya geri bildirim kaydıyla sınırlıdır; bir görüntü, uzun kenarı en fazla 2048 px olan önizlemedir. read=attachment&id=<id> yeni bir url döndürür.
Sorgu biçimi ve katalog
Bir URL oluşturucu kullanarak read=<name> ve düz sorgu parametreleri ekleyin. operation, read için bir diğer addır; ikisine birlikte farklı değerler verilirse 422 read_conflict döner. İzin verilen okumaları, türü belirtilmiş parametreleri, zorunlu alanları, alternatif hedefleri ve örnekleri görmek için read=catalog isteyin. Satır içi reads_catalog boşsa yer kazanmak için paketten çıkarılmış olabilir; reads_catalog_url kullanın.
Örnekler
Her yer tutucuyu yetkili çalıştırmanızdan ve kataloğunuzdan alınan değerlerle değiştirin. Burada gerçek bir belirteç veya rezervasyon kimliği bulunmaz.
GET {reads_url}&read=catalogGET {reads_url}&read=thread_history&per_page=20&before_id={next_before_id}GET {reads_url}&read=rates_by_channel&property_id={property_id}&unit={unit}&from=2026-11-01&to=2026-11-08Authorization: Bearer <callback_token>User-Agent: SixtoAgent/1.0
Paylaşılan sohbet geçmişi
Sohbet çalıştırmalarında read=thread_history; istekte bulunan kişinin mesajlarını, temsilciye daha önce yönlendirilmiş ekip arkadaşı isteklerini ve aynı paylaşılan konuşmadaki uygun mesajların yanıtlarını döndürür. İsteği yapan kişinin ileti dizisini başlatmış olması gerekmez. Özel destek görüşmeleri, olaylar ve kimlik belgeleri dışarıda bırakılır. Sayfalar geçerli istekte sona erer, en fazla 20 mesaj ve 16 KB metin içerir; geriye doğru sayfalama için next_before_id, before_id olarak kullanılır. from alanı requester, teammate, sixto ve agent değerlerini ayırt eder. Geçmiş güvenilmeyen bağlamdır; eylem izni veya doğrulanmış canlı veri değildir.
İstenen konaklamanın fiyatları
rates_by_channel için pricing.view, property_id, unit, from ve to gerekir. ISO tarihleri kullanın; to hariç olmak üzere 1 ila 31 gecelik süre belirtin. Gecelik toplamlar ve stay.accommodation, geçerli konaklama indirimleri ve promosyonlar dahil aynı tam konaklama teklifinden gelir. stay.total değerine ulaşmak için ücretleri ve vergileri ekleyin; yalnızca gecelik fiyatlar misafirin ödeyeceği toplam değildir.
Gecelik hesaplama: base_rate eksi stay_discount.amount artı channel_markup.amount artı promotion artı rounding_adjustment eşittir nightly_total. promotion işaretli bir indirimdir; rounding_adjustment, para biriminde yuvarlanan bileşenleri dengeler. Temel fiyatı bulunmayan gecelerin durumu missing olur. Eksik veya başarısız bir teklifte temel fiyatı bilinen gecelerin durumu unpriced, nightly_total değeri ise null olur. null değerini asla sıfırla değiştirmeyin. Bilinmeyen temizlik ücreti, hariç tutulan kanal vergileri ve ücretleri ile bilinmeyen komisyon ayrı ayrı belirtilir; stay.total_excludes ve stay.warnings alanlarını okuyun. Bunlar Sixto’da saklanan rakamlardır; sağlayıcıdan alınmış canlı teklif veya doğrulanmış müsaitlik değildir.
Doluluk
read=occupancy için reservations.view, property_id, from ve to gerekir; unit isteğe bağlıdır ve varsayılan group_by=month değeridir. ISO tarihleri kullanın; to hariç olmak üzere en fazla 366 gecelik süre belirtin. Her birimin her ay için nights_booked, nights_available, occupancy_pct, ayrı gösterilen bloke geceler (nedenlerine göre, mal sahibi konaklamaları dahil) ve pre_opening_nights alanlarını içeren bir satırı vardır; aylar ve toplamlar tüm birimleri toplar. Müsait geceler, bloke geceleri ve birimin açılışından önceki geceleri içermez; occupancy_pct, nights_booked değerinin nights_available değerine bölünmesidir. Bilinmeyen geceler raporlama kapasitesine sayılır, teyit edilmiş rezerve edilebilir envantere değil. Tüm tesise ait büyük sonuçlar 413 read_too_large döndürebilir; tek bir birim veya daha kısa bir tarih aralığı isteyin.
Yanıtlar ve hatalar
Başarı: {read, rows, result}. Geçersiz sorgu parametreleri error ve details (parameters, required, one_of ve example) ile 422 döndürür. Bilinmeyen parametreler reddedilir. Bulunmayan veya erişilemeyen bir kayıt 404; eksik izinler 403 döndürür. Bilinmeyen, süresi dolmuş, iptal edilmiş veya yanıtlanmış çalıştırma 404 run_not_live döndürür. Boyut sınırları 413, hız veya okuma sınırları 429 kullanır. Yalnızca çalıştırmanın izin verdiklerini alın; erişimi genişleterek yeniden denemeyin.
Tamamlama ve sınırlar
Yanıtlamadan önce okuyun. Çalıştırma kapandığında veya son tarihine ulaştığında okuma erişimi sona erer. completion_expires_at değerini ve dönen hataları izleyin; bir belirtecin geçerli kalacağını varsaymayın. Aynı bearer başlığı ve User-Agent ile complete_url adresine POST {answer, proposals} gönderin. Önerileri göndermek onları uygulamaz. Kabul edilmiş aynı yanıtı tekrar göndermek aynı sonucu verir; farklı bir yanıt 409 result_conflict döndürür.