Sixto API: ekibinizin kullandığı işlemler ve izinler
Sixto API, görevler, kayıtlar, raporlar ve mesajlar gibi uygulamayla aynı işlemleri, yalnızca verdiğiniz kapsamları taşıyan anahtarlarla açar. Her çağrı o anahtarın etkinlik günlüğüne kaydedilir. Anahtar kendi kimliğini ve yapabileceklerini sorgulayabilir. Hassas işlemler bir kişinin onayını bekler.
Kullanılabilir. Kapsamı sınırlı anahtarlara sahip sürümlü REST API; rezervasyonları, misafirleri, görevleri, finansı, girişi, kilitleri, kanalları ve daha fazlasını kapsar.
Araçlarınız, kapsamı sınırlı erişim
API anahtarları yalnızca seçtiğiniz izinleri alır
Neler yapar
Hangi verilerin aktarıldığını, hangilerinin yerinde kaldığını bilin
Oklar, Sixto’ya göre veri akışının yönünü gösterir.
Geniş kapsam
Görevler, rezervasyonlar, misafirler, yorumlar, mesajlar, giriş, uyum, kilitler, kanallar, e-faturalar, banka ve defter, piyasa karşılaştırmaları, arama ve ayarlar.
Tek izin kataloğundan kapsamlı anahtarlar
Anahtarlar kişilerle aynı izin kataloğunu kullanır. İzinleri değiştirmek için bir Sahip yeni anahtar oluşturup eskisini iptal eder. İptal sonraki çağrıda geçerli olur.
Kendi yetkisini açıklar
API'ye kim olduğunuzu ve neler yapabileceğinizi sorun (whoami ve capabilities); her yolun gerekli izinlerini de öğrenin.
Güvenli yeniden denemeler ve etkinlik günlüğü
Her yazma işlemi external_id veya Idempotency-Key başlığı gibi yeniden deneme kimliğini belgeler; aynı kimlik farklı içerikle kullanılırsa 409 döner. Her isteğin kimliği vardır ve etkinlik günlüğünde görünür.
Adil sınırlar
Her anahtarın kendi kotası vardır, varsayılan olarak dakikada 600 istek; yoğun bir anahtar diğerini yavaşlatmaz. GET /api/v1/capabilities güncel değeri bildirir.
Yapay zekâ uygulaması mı tercih ediyorsunuz? MCP kullanın
Sixto, REST API’nin yanı sıra yapay zekâ uygulamaları için OAuth ile oturum açılan bir MCP sunucusu sunar. Kuruluşun Sahip veya Yönetici rolündeki bir kullanıcısı açana kadar kapalıdır. Ayrıca herkese açık, salt okunur bir dokümantasyon MCP’si vardır.
- Sunucu adresi
https://holasixto.com/mcp- Dokümantasyon MCP’si
https://holasixto.com/mcp/docsHerkese açık ve salt okunurdur. Sixto dokümantasyonunda arama yapar; kuruluşunuzun verilerine hiçbir zaman erişmez.
Nasıl çalışır
- 01
Bir Sahip, Ayarlar bölümünde anahtar oluşturup gereken izinleri seçer. Anahtar bir kez gösterilir.
- 02
Bearer belirteci olarak gönderin. Anahtarın yapabileceklerini görmek için whoami ve capabilities çağırın.
- 03
Uç noktalar üzerinden okuyun veya yazın. Yazmalar uygulamayla aynı kontrollerden geçer.
- 04
API etkinlik görünümünde çağrıları izleyin ve istediğiniz zaman anahtarı iptal edin.
Senkronize edilen veriler
Sık sorulan sorular
Geliştirici kılavuzu var mı?
Evet. OpenAPI 3.1 başvurusu /api/v1/openapi.json, istemci kılavuzu /api/v1/guide.json adresindedir. Her işlem x-contract-status gösterir: complete incelenmiş sözleşme, unsupported ise yol kullanılabilir olsa da desteklenen istemci yüzeyinin dışında demektir. Salt okunur belge sunucusu /mcp/docs adresindedir.
Anahtar kimin adına işlem yapar?
Anahtar kuruluş için kendi izinleriyle işlem yapar. Kendine ait tesis listesi yoktur ve oluşturan kişinin tesis sınırlarını devralmaz. Sixto bir kişinin isteğini Sixto-On-Behalf-Of yetki devriyle ilettiğinde kişinin mevcut tesis ve izin sınırları da uygulanır.
Anahtar izinlerini nasıl değiştiririm?
İstediğiniz izinlerle yeni anahtar oluşturun, aracınızı buna geçirin, ardından eski anahtarı iptal edin. Var olan anahtarlar düzenlenemez. İptal edilen anahtar sonraki çağrıda reddedilir.
422 ve 429 ne anlama gelir?
422 doğrulamanın başarısız olduğu anlamına gelir: errors nesnesini alan bazında okuyun, girdiyi düzeltin ve yeniden gönderin. 429 anahtarın sınıra ulaştığı anlamına gelir: Retry-After başlığındaki saniye kadar bekleyin, sonra aralığı uzatarak yeniden deneyin. Çağrıyı etkinlik günlüğünde bulmak için X-Request-Id değerini saklayın.
Anahtar kapı açabilir mi?
Hayır. API üzerinden uzaktan kilit açma hiçbir zaman kullanılamaz.
API sürümlü mü?
Evet, /api/v1 altında bulunur.