Anar al contingut
Sursa Developers

Referència de l’API

L’API pública de Sursa: 222 punts finals en 35 seccions. Versió 1.62.0.

L’API pública de Sursa per a integracions que s’autentiquen amb una clau d’API. Els canvis dins de /v1 són additius: poden aparèixer operacions noves, paràmetres opcionals, camps de resposta i valors d’enumeració a les respostes, i els clients existents continuen funcionant. Considereu vàlids els valors d’enumeració desconeguts a les respostes.

URL base
https://api.sursa.com
Autenticació
Envieu una clau d’API a la capçalera Authorization: Authorization: Bearer <clau>.

Seccions

health1 punt final

Estat i versió del servei

auth1 punt final

Inici de sessió, sessions, mode «View as» (veure la base com la veu un perfil de dades), canvi i restabliment de la contrasenya, acceptació d’invitacions

users5 punts finals

Comptes d’usuari de l’organització

api-keys9 punts finals

Claus d’API de l’organització

apps8 punts finals

Aplicacions OAuth de l’organització i autoritzacions del personal

oauth3 punts finals

El protocol OAuth 2.0: pantalla de consentiment, emissió i revocació de tokens, metadades del servidor d’autorització

audit4 punts finals

Registre d’auditoria de l’organització

org1 punt final

L’organització, el seu logotip i l’exportació de dades

categories4 punts finals

Categories de documents

collections6 punts finals

Col·leccions de coneixement

cards26 punts finals

Entrades de coneixement: pujada, contingut, taules, versions, verificació, comentaris

jobs5 punts finals

Cua d’indexació: treballs, previsualització de l’anàlisi, flux de canvis (SSE)

conversations2 punts finals

Converses amb l’assistent

answers3 punts finals

Cerca i respostes de l’assistent, inclòs el flux SSE

access-requests4 punts finals

Sol·licituds d’accés a les fonts d’una resposta oculta

questions10 punts finals

Registre de preguntes, suggeriments, exportacions de respostes, resposta dinàmica

files8 punts finals

Fitxers d’exportació

insights1 punt final

Anàlisi del coneixement: resum, duplicats, llacunes de coneixement i salut del coneixement

tasks1 punt final

Tasques d’un usuari i d’un equip

sources19 punts finals

Fonts de dades, com ara Google Drive i Confluence

permissions17 punts finals

Model d’accés: el registre de permisos i els permisos sobre l’organització, les col·leccions, les entrades i les fonts, tant concedits directament com heretats

roles4 punts finals

Rols: conjunts de permisos amb nom, integrats i personalitzats

groups7 punts finals

Grups d’usuaris: grups normals, «All members» (tots els membres), grups de rol i grups personals

folders7 punts finals

Carpetes de col·lecció: un arbre de fins a tres nivells de profunditat, ordre respecte d’un element germà, una entrada en diverses carpetes, permisos heretats

catalog6 punts finals

Catàleg de serveis externs (SaaS i proveïdors) amb noms, llocs web, categories, icones i descripcions, i vincles entre els noms de la vostra organització i els elements del catàleg

drafts6 punts finals

Esborranys i aprovació de la publicació

verification9 punts finals

Verificació: estat, dates límit, verificadors, historial, la cua «Verify first» (verificar primer), «Trust Score» (índex de confiança) i baixa d’usuaris

announcements5 punts finals

Avisos de lectura obligatòria: destinataris, confirmació de lectura, informes, recordatoris, exportació

comments4 punts finals

Comentaris en fil a les entrades, amb una àncora i un estat, i reaccions

webhooks17 punts finals

Webhooks de l’organització: webhooks registrats, subscripcions a esdeveniments, signatures, lliuraments i reintents

public-api1 punt final

API pública per a integracions: l’especificació llegible per màquina d’aquesta API

uploads5 punts finals

Pujades per parts de fitxers grans: la sessió, les parts, la finalització amb comprovacions i l’ús per part d’una entrada, un arxiu comprimit o una importació

analytics4 punts finals

Analítiques del producte: esdeveniments d’ús, comptadors per objecte, els taulers de salut, d’ús i de contribució, l’informe de renovació i les exportacions

quality3 punts finals

Qualitat de les respostes: preguntes sense una bona resposta i les llacunes de coneixement en tractament

finance6 punts finals

Documents financers: tipus de canvi i directori de contraparts

Objectes