İş ortağı uygulamaları için OAuth
Bir MonoChat kullanıcısı adına çalışan iş ortağı uygulaması, otomasyon aracı ya da özel uygulama, özel fonksiyon API'sini (POST https://app.monochat.ai/api/<slug>/custom-functions/<path>) API token'ı yerine bir OAuth erişim token'ıyla çağırabilir. Kullanıcı uygulamayı bir MonoChat sayfasında onaylar, erişebileceği organizasyonları seçer ve profil ayarlarındaki Bağlı uygulamalar sekmesinden istediği zaman iptal edebilir.
API token'ları aynı uç noktada çalışmaya devam eder. OAuth, başkaları adına çalışan bir uygulama içindir: uygulama hiçbir parola ya da API token'ı görmez ve her kullanıcı erişimini kendisi kesebilir.
Erişim token'ıyla yapılan bir çağrı, uygulamayı onaylayan kullanıcı olarak ve onun rolleriyle çalışır. Yalnızca organizasyonun özel metotlarını, yalnızca kullanıcının temsilci olduğu organizasyonlarda çalıştırır.
İstemci alın
Uygulamanız için MonoChat'ten bir istemci isteyin. MonoChat istemciyi şu bilgilerle kaydeder:
- onay sayfasının ve Bağlı uygulamalar sekmesinin gösterdiği uygulama adı;
- birebir eşleşen yönlendirme URI'leri:
httpsadresleri ya dalocalhost,127.0.0.1veya[::1]üzerindehttp(her port); - isteyebileceği kapsamlar: bu API için
custom-functions:run.
Bir istemci kimliği (monochat_rc_ ile başlar) ve bir istemci gizli anahtarı (monochat_cs_ ile başlar) alırsınız. Gizli anahtar yalnızca bir kez gösterilir; MonoChat yalnızca özetini saklar. Onu sunucunuzda tutun, asla bir tarayıcıda ya da mobil uygulamada değil.
Gizli anahtar saklayamayan bir uygulama (tarayıcıda ya da kullanıcının bilgisayarında çalışan bir uygulama gibi) istemci kimliği olarak, MCP istemcilerinin yaptığı gibi bir client ID metadata belgesinin URL'sini kullanabilir. Bu durumda gizli anahtar göndermez.