Servor. docs
en

API Historique de commandes

Lisez l'historique de commandes d'un serveur via l'API Servor avec un jeton commands:read — chaque commande exécutée, consultable et exportable.

Lisez l'historique de commandes enregistré d'un serveur via l'API. Chaque commande exécutée sur un serveur — depuis le terminal web, l'exécution de commandes ou le copilote IA — est sauvegardée dans un historique consultable, et cet endpoint permet de le récupérer pour des audits, des exports ou vos propres tableaux de bord.

Cet endpoint requiert le scope commands:read.

get/v1/servers/{id}/commandsScope: commands:read

List command history for a server

Paramètres

  • iduuidpath · requis

    The server id.

  • pageintegerquery · optionnel

    1-based page number (default 1).

  • pageSizeintegerquery · optionnel

    Items per page, max 100 (default 20).

Exemple de requête

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

Exemple de réponse

{
  "items": [
    {
      "id": "uuid",
      "command": "uptime",
      "source": "manual",
      "status": "succeeded",
      "exitCode": 0,
      "durationMs": 42,
      "startedAt": "2026-08-20T10:00:00.000Z",
      "finishedAt": "2026-08-20T10:00:00.100Z",
      "createdAt": "2026-08-20T10:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 20
}

Ce que vous récupérez

GET /v1/servers/{id}/commands renvoie l'historique de commandes d'un serveur, les plus récentes en premier. Chaque entrée enregistre ce qui a été exécuté et quand, de quoi reconstituer qui a fait quoi dans le temps.

Il vous faut d'abord l'id du serveur — obtenez-le via l'API Serveurs :

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

Puis lisez l'historique de commandes de ce serveur :

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

Lecture seule, toujours

L'API peut lire l'historique de commandes mais n'exécute jamais de commande. L'exécution est signée dans votre navigateur, ce qu'un jeton ne peut pas faire — il n'existe donc volontairement aucun endpoint « exécuter une commande ». Utilisez le terminal web ou l'exécution de commandes dans le tableau de bord pour exécuter quoi que ce soit — ouvrez vos serveurs dans Servor.

Remarques

  • L'historique inclut les commandes exécutées par le copilote IA : cet endpoint est donc un bon moyen de revoir ce que le copilote a fait a posteriori.
  • Les commandes dangereuses sont bloquées avant toute exécution par une blacklist partagée ; elles n'apparaissent donc pas comme exécutées dans l'historique.
  • Un 403 signifie que votre jeton n'a pas le scope commands:read ; un 404 signifie que l'id du serveur n'existe pas ou n'appartient pas à votre équipe. Voir les erreurs.

Voir aussi

API ServeursListez les serveurs pour obtenir leurs identifiants.API Journal d'auditUn relevé plus large de l'activité de l'équipe.Exécuter des commandesExécutez des commandes depuis le tableau de bord.Terminal webUn shell en direct dans le navigateur.
PrécédentPages de statutSuivantAudit