Aller au contenu
Sursa Developers

Référence de l’API

L’API publique de Sursa : 222 points de terminaison répartis en 35 sections. Version 1.62.0.

L’API publique de Sursa pour les intégrations qui s’authentifient avec une clé API. Les changements au sein de /v1 sont additifs : de nouvelles opérations, des paramètres facultatifs, des champs de réponse et des valeurs d’énumération dans les réponses peuvent apparaître, et les clients existants continuent de fonctionner. Traitez les valeurs d’énumération inconnues dans les réponses comme valides.

URL de base
https://api.sursa.com
Authentification
Envoyez une clé API dans l’en-tête Authorization : Authorization: Bearer <clé>.

Sections

health1 point de terminaison

État et version du service

auth1 point de terminaison

Connexion, sessions, mode « View as » (voir en tant que), changement et réinitialisation du mot de passe, acceptation des invitations

users5 points de terminaison

Comptes utilisateurs de l’organisation

api-keys9 points de terminaison

Clés API de l’organisation

apps8 points de terminaison

Applications OAuth de l’organisation et autorisations des salariés

oauth3 points de terminaison

Le protocole OAuth 2.0 : écran de consentement, émission et révocation des jetons, métadonnées du serveur d’autorisation

audit4 points de terminaison

Journal d’audit de l’organisation

org1 point de terminaison

L’organisation, son logo et l’export des données

categories4 points de terminaison

Catégories de documents

collections6 points de terminaison

Collections de connaissances

cards26 points de terminaison

Fiches de connaissances : téléversement, contenu, tableaux, versions, validation, commentaires

jobs5 points de terminaison

File d’indexation : jobs, aperçu de l’analyse, flux des modifications (SSE)

conversations2 points de terminaison

Conversations avec l’assistant

answers3 points de terminaison

Recherche et réponses de l’assistant, y compris le flux SSE

access-requests4 points de terminaison

Demandes d’accès aux sources d’une réponse masquée

questions10 points de terminaison

Journal des questions, suggestions, exports de réponses, réponse dynamique

files8 points de terminaison

Fichiers d’export

insights1 point de terminaison

Analyse des connaissances : synthèse, doublons, lacunes de connaissances et santé des connaissances

tasks1 point de terminaison

Tâches d’un utilisateur et d’une équipe

sources19 points de terminaison

Sources de données, comme Google Drive et Confluence

permissions17 points de terminaison

Modèle d’accès : le registre des permissions et les permissions sur l’organisation, les collections, les fiches et les sources, accordées directement ou héritées

roles4 points de terminaison

Rôles : ensembles nommés de permissions, intégrés et personnalisés

groups7 points de terminaison

Groupes d’utilisateurs : groupes ordinaires, « All members » (tous les membres), groupes de rôle et groupes personnels

folders7 points de terminaison

Dossiers des collections : une arborescence jusqu’à trois niveaux, ordre par rapport à un élément de même niveau, une fiche dans plusieurs dossiers, permissions héritées

catalog6 points de terminaison

Catalogue de services externes (SaaS et éditeurs) avec noms, sites web, catégories, icônes et descriptions, et liens entre les noms utilisés dans votre organisation et les entrées du catalogue

drafts6 points de terminaison

Brouillons et approbation de publication

verification9 points de terminaison

Validation : état, échéances, valideurs, historique, file « Verify first » (à valider en priorité), « Trust Score » (indice de confiance) et procédure de départ

announcements5 points de terminaison

Annonces à lecture obligatoire : destinataires, confirmation de lecture, rapports, rappels, export

comments4 points de terminaison

Fils de commentaires sur les fiches, avec ancre et statut, et réactions

webhooks17 points de terminaison

Webhooks de l’organisation : les webhooks avec leurs abonnements aux événements, signatures, livraisons et nouvelles tentatives

public-api1 point de terminaison

API publique pour les intégrations : la spécification de cette API lisible par machine

uploads5 points de terminaison

Téléversements de gros fichiers en plusieurs parties : la session, les parties, la finalisation avec vérifications et l’utilisation par une fiche, une archive ou un import

analytics4 points de terminaison

Analyses produit : événements d’utilisation, compteurs par objet, tableaux de bord de santé, d’utilisation et des contributions, rapport de renouvellement et exports

quality3 points de terminaison

Qualité des réponses : questions sans bonne réponse et lacunes de connaissances prises en charge

finance6 points de terminaison

Documents financiers : taux de change et répertoire des tiers

Objets