Ugrás a tartalomra
Sursa Developers

API-referencia

A nyilvános Sursa API: 222 végpont 35 szakaszban. Verzió: 1.62.0.

A Sursa nyilvános API-ja API-kulccsal hitelesítő integrációkhoz. A /v1 verzión belüli változások bővítő jellegűek: megjelenhetnek új műveletek, nem kötelező paraméterek, válaszmezők és új enumértékek a válaszokban, a meglévő kliensek pedig továbbra is működnek. A válaszokban szereplő ismeretlen enumértékeket kezeld érvényesként.

Alap-URL
https://api.sursa.com
Hitelesítés
Küldj egy API-kulcsot az Authorization fejlécben: Authorization: Bearer <kulcs>.

Szakaszok

health1 végpont

A szolgáltatás állapota és verziója

auth1 végpont

Bejelentkezés, munkamenetek, „View as” mód (megtekintés más felhasználóként), jelszó módosítása és visszaállítása, meghívók elfogadása

users5 végpont

A szervezet felhasználói fiókjai

api-keys9 végpont

A szervezet API-kulcsai

apps8 végpont

A szervezet OAuth-alkalmazásai és a munkatársak engedélyezései

oauth3 végpont

Az OAuth 2.0 protokoll: hozzájárulási képernyő, tokenek kiadása és visszavonása, az engedélyezési kiszolgáló metaadatai

audit4 végpont

A szervezet auditnaplója

org1 végpont

A szervezet, a logója és az adatok exportálása

categories4 végpont

Dokumentumkategóriák

collections6 végpont

Tudásgyűjtemények

cards26 végpont

Tudáskártyák: feltöltés, tartalom, táblázatok, verziók, ellenőrzés, hozzászólások

jobs5 végpont

Indexelési sor: feladatok, feldolgozási előnézet, változásfolyam (SSE)

conversations2 végpont

Beszélgetések az asszisztenssel

answers3 végpont

Keresés és az asszisztens válaszai, az SSE-adatfolyammal együtt

access-requests4 végpont

Hozzáférési kérelmek egy elrejtett válasz forrásaihoz

questions10 végpont

Kérdésnapló, javaslatok, válaszok exportálása, élő válasz

files8 végpont

Exportfájlok

insights1 végpont

Tudáselemzések: összesítés, ismétlődések, tudáshiányok és a tudás állapota

tasks1 végpont

Felhasználó és csapat teendői

sources19 végpont

Adatforrások, például a Google Drive és a Confluence

permissions17 végpont

Hozzáférési modell: a jogosultságjegyzék, valamint a szervezetre, a gyűjteményekre, a kártyákra és a forrásokra vonatkozó jogosultságok, közvetlenül kiosztva és örökölve egyaránt

roles4 végpont

Szerepkörök: a jogosultságok elnevezett készletei, beépítettek és egyéniek

groups7 végpont

Felhasználói csoportok: szokásos csoportok, „All members” (minden tag), szerepkör-csoportok és személyes csoportok

folders7 végpont

Gyűjteménymappák: legfeljebb háromszintű fa, sorrend egy testvérelemhez képest, egy kártya több mappában, örökölt jogosultságok

catalog6 végpont

Külső szolgáltatások (SaaS és szállítók) katalógusa nevekkel, webhelyekkel, kategóriákkal, ikonokkal és leírásokkal, valamint a szervezeted által használt nevek és a katalógusbejegyzések közötti kapcsolatok

drafts6 végpont

Piszkozatok és a közzététel jóváhagyása

verification9 végpont

Ellenőrzés: állapot, határidők, ellenőrzők, előzmények, a „Verify first” sor (az elsőként ellenőrizendő kártyák), Trust Score (megbízhatósági pontszám) és kiléptetés

announcements5 végpont

Kötelezően olvasandó közlemények: célközönség, olvasás megerősítése, jelentések, emlékeztetők, exportálás

comments4 végpont

Szálakba rendezett hozzászólások a kártyákon horgonnyal és állapottal, valamint reakciók

webhooks17 végpont

A szervezet webhookjai: a webhookok beállítása, az eseményfeliratkozások, az aláírások, a kézbesítések és az újrapróbálkozások

public-api1 végpont

Nyilvános API integrációkhoz: ennek az API-nak a géppel olvasható specifikációja

uploads5 végpont

Nagy fájlok többrészes feltöltése: a munkamenet, a részek, a befejezés ellenőrzésekkel, valamint a felhasználás kártyához, archívumhoz vagy importáláshoz

analytics4 végpont

Termékanalitika: használati események, objektumonkénti számlálók, a tudás állapotát, a használatot és a hozzájárulást mutató irányítópultok, a megújítási jelentés és az exportálások

quality3 végpont

A válaszok minősége: a jó válasz nélkül maradt kérdések és a munkába vett tudáshiányok

finance6 végpont

Pénzügyi dokumentumok: árfolyamok és a partnertörzs

Objektumok