Gå til indholdet
Sursa Developers

API-reference

Sursas offentlige API: 222 operationer i 35 sektioner. Version 1.62.0.

Sursas offentlige API til integrationer, der autentificeres med en API-nøgle. Ændringer inden for /v1 er tilføjende: nye operationer, valgfrie parametre, felter i svar og enum-værdier i svar kan komme til, og eksisterende klienter fortsætter med at virke. Behandl ukendte enum-værdier i svar som gyldige.

Basis-URL
https://api.sursa.com
Autentificering
Send en API-nøgle i headeren Authorization: Authorization: Bearer <nøgle>.

Sektioner

health1 operation

Tjenestens status og version

auth1 operation

Login, sessioner, tilstanden »View as« (vis som), ændring og nulstilling af adgangskode, accept af invitationer

users5 operationer

Organisationens brugerkonti

api-keys9 operationer

Organisationens API-nøgler

apps8 operationer

Organisationens OAuth-apps og medarbejderes autorisationer

oauth3 operationer

OAuth 2.0-protokollen: samtykkeskærm, udstedelse og tilbagekaldelse af tokens, autorisationsserverens metadata

audit4 operationer

Organisationens revisionslog

org1 operation

Organisationen, dens logo og eksport af data

categories4 operationer

Dokumentkategorier

collections6 operationer

Samlinger af viden

cards26 operationer

Videnskort: upload, indhold, tabeller, versioner, verificering, kommentarer

jobs5 operationer

Indekseringskø: job, forhåndsvisning af parsing, ændringsstream (SSE)

conversations2 operationer

Samtaler med assistenten

answers3 operationer

Søgning og assistentens svar, herunder SSE-streamen

access-requests4 operationer

Anmodninger om adgang til kilderne bag et skjult svar

questions10 operationer

Spørgsmålslog, forslag, eksport af svar, live-svar

files8 operationer

Eksportfiler

insights1 operation

Vidensindsigt: oversigt, dubletter, videnshuller og vidensbasens sundhed

tasks1 operation

Opgaver for en bruger og for et team

sources19 operationer

Datakilder som Google Drive og Confluence

permissions17 operationer

Adgangsmodel: registret over tilladelser og tilladelser på organisationen, samlinger, kort og kilder, både tildelt direkte og arvet

roles4 operationer

Roller: navngivne sæt af tilladelser, indbyggede og brugerdefinerede

groups7 operationer

Brugergrupper: almindelige grupper, »All members« (alle medlemmer), rollegrupper og personlige grupper

folders7 operationer

Mapper i samlinger: et træ med op til tre niveauer, rækkefølge i forhold til et naboelement, ét kort i flere mapper, arvede tilladelser

catalog6 operationer

Katalog over eksterne tjenester (SaaS og leverandører) med navne, websteder, kategorier, ikoner og beskrivelser samt koblinger mellem din organisations navne og poster i kataloget

drafts6 operationer

Udkast og godkendelse af publicering

verification9 operationer

Verificering: status, frister, kontrollanter, historik, køen »Verify first« (verificér først), tillidsscore og offboarding

announcements5 operationer

Meddelelser til obligatorisk læsning: målgruppe, læsebekræftelse, rapporter, påmindelser, eksport

comments4 operationer

Kommentartråde på kort med et anker og en status samt reaktioner

webhooks17 operationer

Organisationens webhooks: slutpunkter, abonnementer på hændelser, signaturer, leveringer og nye forsøg

public-api1 operation

Offentligt API til integrationer: den maskinlæsbare specifikation af dette API

uploads5 operationer

Multipart-upload af store filer: sessionen, delene, afslutning med kontroller og brug i et kort, et arkiv eller en import

analytics4 operationer

Produktanalyse: brugshændelser, tællere pr. objekt, dashboards for sundhed, brug og bidrag, fornyelsesrapporten og eksporter

quality3 operationer

Svarkvalitet: spørgsmål uden et godt svar og videnshuller, der er taget under behandling

finance6 operationer

Økonomiske dokumenter: valutakurser og registret over modparter

Objekter