Langsung ke konten
Sursa Developers

Referensi API

API publik Sursa: 222 endpoint dalam 35 bagian. Versi 1.62.0.

API Sursa publik untuk integrasi yang melakukan autentikasi dengan kunci API. Perubahan di dalam /v1 bersifat tambahan: operasi baru, parameter opsional, field respons, dan nilai enum respons dapat muncul, dan klien yang sudah ada tetap berfungsi. Perlakukan nilai enum yang tidak dikenal dalam respons sebagai nilai yang valid.

URL dasar
https://api.sursa.com
Autentikasi
Kirim kunci API di header Authorization: Authorization: Bearer <kunci>.

Bagian

health1 endpoint

Status dan versi layanan

auth1 endpoint

Masuk, sesi, mode “View as” (Lihat sebagai), perubahan dan reset kata sandi, penerimaan undangan

users5 endpoint

Akun pengguna organisasi

api-keys9 endpoint

Kunci API organisasi

apps8 endpoint

Aplikasi OAuth organisasi dan otorisasi karyawan

oauth3 endpoint

Protokol OAuth 2.0: layar izin, penerbitan dan pencabutan token, metadata server otorisasi

audit4 endpoint

Log audit organisasi

org1 endpoint

Organisasi, logonya, dan ekspor data

categories4 endpoint

Kategori dokumen

collections6 endpoint

Koleksi pengetahuan

cards26 endpoint

Kartu pengetahuan: unggahan, konten, tabel, versi, verifikasi, komentar

jobs5 endpoint

Antrean pengindeksan: job, pratinjau penguraian, stream perubahan (SSE)

conversations2 endpoint

Percakapan dengan asisten

answers3 endpoint

Pencarian dan jawaban asisten, termasuk stream SSE

access-requests4 endpoint

Permintaan akses ke sumber jawaban yang tersembunyi

questions10 endpoint

Log pertanyaan, saran, ekspor jawaban, jawaban live

files8 endpoint

File ekspor

insights1 endpoint

Insight pengetahuan: ringkasan, duplikat, celah pengetahuan, dan kesehatan pengetahuan

tasks1 endpoint

Tugas pengguna dan tim

sources19 endpoint

Sumber data, seperti Google Drive dan Confluence

permissions17 endpoint

Model akses: daftar izin dan izin pada organisasi, koleksi, kartu, dan sumber, baik yang diberikan langsung maupun yang diwarisi

roles4 endpoint

Peran: kumpulan izin bernama, bawaan dan kustom

groups7 endpoint

Grup pengguna: grup biasa, “All members” (Semua anggota), grup peran, dan grup pribadi

folders7 endpoint

Folder koleksi: pohon hingga tiga tingkat, urutan relatif terhadap elemen sejajar, satu kartu di beberapa folder, izin yang diwarisi

catalog6 endpoint

Katalog layanan eksternal (SaaS dan vendor) dengan nama, situs web, kategori, ikon, dan deskripsi, serta tautan antara nama di organisasi Anda dan entri katalog

drafts6 endpoint

Draf dan persetujuan publikasi

verification9 endpoint

Verifikasi: status, tenggat, verifikator, riwayat, antrean “verifikasi dulu”, Trust Score (skor kepercayaan), dan offboarding

announcements5 endpoint

Pengumuman wajib baca: audiens, konfirmasi baca, laporan, pengingat, ekspor

comments4 endpoint

Komentar kartu berutas dengan jangkar dan status, serta reaksi

webhooks17 endpoint

Webhook organisasi: pendaftaran webhook, langganan peristiwa, tanda tangan, pengiriman, dan percobaan ulang

public-api1 endpoint

API publik untuk integrasi: spesifikasi API ini yang dapat dibaca mesin

uploads5 endpoint

Unggahan multibagian untuk file besar: sesi, bagian, penyelesaian dengan pemeriksaan, dan penggunaan oleh kartu, arsip, atau impor

analytics4 endpoint

Analitik produk: peristiwa penggunaan, penghitung per objek, dasbor kesehatan, penggunaan, dan kontribusi, laporan perpanjangan, serta ekspor

quality3 endpoint

Kualitas jawaban: pertanyaan tanpa jawaban yang baik dan celah pengetahuan yang sedang ditangani

finance6 endpoint

Dokumen keuangan: kurs dan direktori pihak lawan transaksi

Objek