Vai al contenuto
Sursa Developers

Riferimento API

L’API pubblica di Sursa: 222 endpoint in 35 sezioni. Versione 1.62.0.

L’API pubblica di Sursa per le integrazioni che si autenticano con una chiave API. Le modifiche all’interno di /v1 sono additive: possono comparire nuove operazioni, parametri facoltativi, campi della risposta e valori di enumerazione nelle risposte, e i client esistenti continuano a funzionare. Considera validi i valori di enumerazione sconosciuti nelle risposte.

URL di base
https://api.sursa.com
Autenticazione
Invia una chiave API nell’intestazione Authorization: Authorization: Bearer <chiave>.

Sezioni

health1 endpoint

Stato e versione del servizio

auth1 endpoint

Accesso, sessioni, modalità “View as”, modifica e reimpostazione della password, accettazione degli inviti

users5 endpoint

Account utente dell’organizzazione

api-keys9 endpoint

Chiavi API dell’organizzazione

apps8 endpoint

App OAuth dell’organizzazione e autorizzazioni dei dipendenti

oauth3 endpoint

Il protocollo OAuth 2.0: schermata di consenso, emissione e revoca dei token, metadati del server di autorizzazione

audit4 endpoint

Registro di audit dell’organizzazione

org1 endpoint

L’organizzazione, il suo logo e l’esportazione dei dati

categories4 endpoint

Categorie dei documenti

collections6 endpoint

Raccolte di conoscenza

cards26 endpoint

Schede di conoscenza: caricamento, contenuto, tabelle, versioni, verifica, commenti

jobs5 endpoint

Coda di indicizzazione: job, anteprima dell’analisi, stream delle modifiche (SSE)

conversations2 endpoint

Conversazioni con l’assistente

answers3 endpoint

Ricerca e risposte dell’assistente, compreso lo stream SSE

access-requests4 endpoint

Richieste di accesso alle fonti di una risposta nascosta

questions10 endpoint

Registro delle domande, suggerimenti, esportazioni delle risposte, risposta dinamica

files8 endpoint

File di esportazione

insights1 endpoint

Analisi della conoscenza: sintesi, duplicati, lacune di conoscenza e stato di salute della conoscenza

tasks1 endpoint

Attività di un utente e di un team

sources19 endpoint

Fonti dati, come Google Drive e Confluence

permissions17 endpoint

Modello di accesso: il registro dei permessi e i permessi sull’organizzazione, sulle raccolte, sulle schede e sulle fonti, sia concessi direttamente sia ereditati

roles4 endpoint

Ruoli: insiemi di permessi con un nome, predefiniti e personalizzati

groups7 endpoint

Gruppi di utenti: gruppi normali, “All members”, gruppi di ruolo e gruppi personali

folders7 endpoint

Cartelle delle raccolte: un albero fino a tre livelli di profondità, ordine rispetto a un elemento allo stesso livello, una scheda in più cartelle, permessi ereditati

catalog6 endpoint

Catalogo dei servizi esterni (SaaS e fornitori) con nomi, siti web, categorie, icone e descrizioni, e collegamenti tra i nomi usati dalla tua organizzazione e le voci del catalogo

drafts6 endpoint

Bozze e approvazione della pubblicazione

verification9 endpoint

Verifica: stato, scadenze, verificatori, cronologia, la coda “Verify first”, “Trust Score” e offboarding

announcements5 endpoint

Comunicazioni di lettura obbligatoria: destinatari, conferma di lettura, report, promemoria, esportazione

comments4 endpoint

Commenti alle schede organizzati in discussioni, con ancoraggio e stato, e reazioni

webhooks17 endpoint

Webhook dell’organizzazione: registrazione dei webhook, sottoscrizioni agli eventi, firme, consegne e nuovi tentativi

public-api1 endpoint

API pubblica per le integrazioni: la specifica leggibile dalle macchine di questa API

uploads5 endpoint

Caricamenti in parti di file di grandi dimensioni: la sessione, le parti, il completamento con i controlli e l’uso da parte di una scheda, di un archivio o di un’importazione

analytics4 endpoint

Analisi del prodotto: eventi di utilizzo, contatori per oggetto, le dashboard di stato di salute, di utilizzo e dei contributi, il report di rinnovo e le esportazioni

quality3 endpoint

Qualità delle risposte: domande senza una buona risposta e lacune di conoscenza prese in carico

finance6 endpoint

Documenti finanziari: tassi di cambio e anagrafica delle controparti

Oggetti