İçeriğe geç
Sursa Developers

API başvurusu

Herkese açık Sursa API: 35 bölümde 222 uç nokta. Sürüm 1.62.0.

API anahtarıyla kimlik doğrulayan entegrasyonlar için Sursa’nın herkese açık API’si. /v1 içindeki değişiklikler ekleme niteliğindedir: yeni işlemler, isteğe bağlı parametreler, yanıt alanları ve yanıtlarda yeni enum değerleri eklenebilir; mevcut istemciler çalışmaya devam eder. Yanıtlardaki bilinmeyen enum değerlerini geçerli sayın.

Temel URL
https://api.sursa.com
Kimlik doğrulama
API anahtarını Authorization başlığında gönderin: Authorization: Bearer <anahtar>.

Bölümler

health1 uç nokta

Hizmet durumu ve sürümü

auth1 uç nokta

Oturum açma, oturumlar, “View as” modu, parola değiştirme ve sıfırlama, davetleri kabul etme

users5 uç nokta

Kuruluşun kullanıcı hesapları

api-keys9 uç nokta

Kuruluşun API anahtarları

apps8 uç nokta

Kuruluşun OAuth uygulamaları ve çalışan yetkilendirmeleri

oauth3 uç nokta

OAuth 2.0 protokolü: onay ekranı, belirteç verme ve iptal etme, yetkilendirme sunucusu meta verileri

audit4 uç nokta

Kuruluşun denetim kaydı

org1 uç nokta

Kuruluş, logosu ve veri dışa aktarma

categories4 uç nokta

Belge kategorileri

collections6 uç nokta

Bilgi koleksiyonları

cards26 uç nokta

Bilgi kartları: yükleme, içerik, tablolar, sürümler, doğrulama, yorumlar

jobs5 uç nokta

Dizinleme kuyruğu: işler, ayrıştırma önizlemesi, değişiklik akışı (SSE)

conversations2 uç nokta

Asistanla sohbetler

answers3 uç nokta

Arama ve asistanın yanıtları, SSE akışı dahil

access-requests4 uç nokta

Gizlenen bir yanıtın kaynaklarına erişim talepleri

questions10 uç nokta

Soru kaydı, öneriler, yanıt dışa aktarmaları, canlı yanıt

files8 uç nokta

Dışa aktarma dosyaları

insights1 uç nokta

Bilgi analizleri: özet, yinelenen kartlar, bilgi boşlukları ve bilgi sağlığı

tasks1 uç nokta

Kullanıcının ve ekibin görevleri

sources19 uç nokta

Google Drive ve Confluence gibi veri kaynakları

permissions17 uç nokta

Erişim modeli: izin listesi ve kuruluş, koleksiyonlar, kartlar ve kaynaklar üzerindeki doğrudan verilen ve devralınan izinler

roles4 uç nokta

Roller: yerleşik ve özel, adlandırılmış izin kümeleri

groups7 uç nokta

Kullanıcı grupları: normal gruplar, “All members” (tüm üyeler), rol grupları ve kişisel gruplar

folders7 uç nokta

Koleksiyon klasörleri: en fazla üç seviye derinliğinde bir ağaç, kardeş öğeye göre sıralama, bir kartın birden çok klasörde yer alması, devralınan izinler

catalog6 uç nokta

Adları, web siteleri, kategorileri, simgeleri ve açıklamalarıyla harici hizmetler (SaaS ve tedarikçiler) kataloğu ve kuruluşunuzdaki adlarla katalog kayıtları arasındaki bağlantılar

drafts6 uç nokta

Taslaklar ve yayın onayı

verification9 uç nokta

Doğrulama: durum, son tarihler, doğrulayıcılar, geçmiş, “Verify first” kuyruğu (önce doğrulanacak kartlar), Trust Score (güven puanı) ve işten ayrılış

announcements5 uç nokta

Zorunlu okuma duyuruları: hedef kitle, okundu onayı, raporlar, hatırlatmalar, dışa aktarma

comments4 uç nokta

Bağlandığı metin parçası ve durumu olan yorum dizileri hâlinde kart yorumları ve tepkiler

webhooks17 uç nokta

Kuruluşun webhook’ları: webhook nesneleri, olay abonelikleri, imzalar, teslimler ve yeniden denemeler

public-api1 uç nokta

Entegrasyonlar için herkese açık API: bu API’nin makine tarafından okunabilir spesifikasyonu

uploads5 uç nokta

Büyük dosyaların çok parçalı yüklemeleri: oturum, parçalar, denetimlerle tamamlama ve bir kartta, arşivde ya da içe aktarmada kullanım

analytics4 uç nokta

Ürün analitiği: kullanım olayları, nesne başına sayaçlar, sağlık, kullanım ve katkı panelleri, yenileme raporu ve dışa aktarmalar

quality3 uç nokta

Yanıt kalitesi: iyi bir yanıtı olmayan sorular ve üzerinde çalışmaya alınan bilgi boşlukları

finance6 uç nokta

Finansal belgeler: döviz kurları ve karşı taraf rehberi

Nesneler