API Journal d'audit

Lisez le journal d'audit de votre équipe via l'API Servor avec un jeton audit:read — un relevé chronologique de qui a fait quoi, pour la conformité et la sécurité.

Lisez le journal d'audit de votre équipe via l'API. Le journal d'audit est un relevé chronologique des actions importantes de votre équipe — qui a fait quoi, et quand — ce qui en fait la colonne vertébrale de tout export de conformité, revue de sécurité ou intégration SIEM que vous voulez bâtir au-dessus de Servor.

Cet endpoint requiert le scope audit:read.

get/v1/auditScope: audit:read

List audit entries (paginated)

Paramètres

actionstringquery · optionnel
Filter by action-type prefix, e.g. "incident.".
limitintegerquery · optionnel
Page size, 1–100 (default 50).
cursorstringquery · optionnel
Opaque cursor from a previous response's nextCursor. Omit for the first page. An unrecognised cursor is ignored and the first page returned.

Exemple de requête

curl https://api.servor.app/v1/audit \
  -H "Authorization: Bearer sv_live_..."

Exemple de réponse

{
  "items": [
    {
      "id": "uuid",
      "actionType": "incident.created",
      "resourceType": "incident",
      "resourceId": "uuid",
      "ipAddress": "203.0.113.10",
      "createdAt": "2026-08-20T10:00:00.000Z"
    }
  ],
  "nextCursor": "djEuMDE5ZWNkMzc..."
}

Ce que vous récupérez

GET /v1/audit renvoie les entrées d'audit de votre équipe, les plus récentes en premier. Chaque entrée capture une action et l'acteur qui l'a réalisée, de quoi répondre à « qui a modifié ceci, et quand ? » bien après les faits.

curl https://api.servor.app/v1/audit \
  -H "Authorization: Bearer sv_live_..."

Parcourir un journal qui s'écrit pendant que vous le lisez

La réponse est une enveloppe : items et nextCursor. Tant que nextCursor n'est pas null, repassez-le en ?cursor= pour obtenir la page suivante.

curl "https://api.servor.app/v1/audit?limit=100&cursor=djEuMDE5ZWNk..." \
  -H "Authorization: Bearer sv_live_..."

Pourquoi un curseur et pas un numéro de page

Un journal reçoit de nouvelles entrées pendant que vous le parcourez. Avec ?page=2, les entrées arrivées entre-temps poussent les anciennes de l'autre côté de la frontière : vous en voyez certaines deux fois et vous en manquez d'autres, sans la moindre erreur. Un export d'audit silencieusement incomplet est le pire mode de défaillance possible. Le curseur désigne une ligne précise, donc ce qui arrive au-dessus ne déplace jamais ce qui suit.

Un curseur non reconnu est ignoré et la première page renvoyée — jamais une erreur.

Exports réguliers

Pour la conformité, vous voudrez généralement récupérer le journal d'audit de façon planifiée et le stocker dans votre propre système. Restez dans les limites de débit — un export périodique, pas une boucle serrée.

Journal d'audit et historique de commandes

Les deux sont des relevés d'activité, mais ils répondent à des questions différentes :

	Journal d'audit	Historique de commandes
Portée	Actions à l'échelle de l'équipe	Commandes exécutées sur un serveur
Répond à	« Qui a modifié ceci ? »	« Qu'a-t-on exécuté ici ? »
Scope requis	`audit:read`	`commands:read`

Utilisez le journal d'audit pour l'activité de l'équipe et du compte ; utilisez l'historique de commandes pour les commandes exactes exécutées sur un serveur donné.

Remarques

Le journal d'audit ne contient jamais de secrets, de phrases de passe ni de données chiffrées — uniquement le fait qu'une action a eu lieu et qui l'a réalisée.
Le même journal est consultable dans le tableau de bord — ouvrir le journal d'audit dans Servor.
Un 403 signifie que votre jeton n'a pas le scope audit:read. Voir les erreurs pour la liste complète des codes de statut.

Voir aussi

API Historique de commandesRelevés de commandes par serveur.ScopesN'accordez que l'accès nécessaire à un jeton.Rôles et permissionsQui peut faire quoi dans une équipe.Limites de débitCadencez vos exports.