API Serveurs

Lisez les serveurs de votre équipe via l'API. Ces endpoints servent à construire un inventaire, alimenter vos propres tableaux de bord ou retrouver l'id d'un serveur avant d'en lire l'historique de commandes. Tout est en lecture seule : l'ajout et la modification des serveurs restent dans le tableau de bord : ajouter un serveur dans Servor.

Ces endpoints requièrent le scope servers:read.

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

[
  {
    "id": "uuid",
    "name": "web-01",
    "host": "203.0.113.10",
    "os": "debian",
    "tags": [
      "prod"
    ],
    "lastSeenAt": "2026-08-20T10:00:00.000Z",
    "createdAt": "2026-08-01T00:00:00.000Z"
  }
]

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

{
  "id": "uuid",
  "name": "web-01",
  "host": "203.0.113.10",
  "os": "debian",
  "tags": [
    "prod"
  ],
  "lastSeenAt": "2026-08-20T10:00:00.000Z",
  "createdAt": "2026-08-01T00:00:00.000Z"
}

Ce que vous récupérez

• GET /v1/servers — la liste des serveurs de votre équipe.
• GET /v1/servers/{id} — le détail d'un serveur.

Exemple

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

Reprenez un id de cette liste pour lire un serveur :

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

Remarques

• Les réponses n'incluent jamais d'identifiants SSH ni de données chiffrées.
• Pour lire l'historique de commandes d'un serveur, voir l'API Commandes.
• Un 403 signifie que votre jeton n'a pas le scope servers:read ; un 404 signifie que l'id du serveur n'existe pas ou n'appartient pas à votre équipe. Voir les erreurs.

Voir aussi