Servor. docs
en

API Moniteurs

Lisez vos moniteurs de disponibilité et leur historique de vérifications via l'API Servor avec un jeton monitors:read.

Lisez les moniteurs de votre équipe et récupérez leur historique de vérifications récent. Ces endpoints servent à construire des tableaux de bord, exporter vos données de disponibilité ou alimenter l'état de vos moniteurs dans vos propres outils. Tout est en lecture seule : la création et la modification des moniteurs restent dans le tableau de bord : ouvrir les moniteurs dans Servor.

Ces endpoints requièrent le scope monitors:read.

get/v1/monitorsScope: monitors:read

List monitors

Exemple de requête

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

Exemple de réponse

[
  {
    "id": "uuid",
    "name": "Homepage",
    "type": "http",
    "status": "up",
    "enabled": true,
    "intervalSeconds": 60,
    "lastCheckAt": "2026-08-20T10:00:00.000Z",
    "lastStatusChangeAt": null
  }
]
get/v1/monitors/{id}/checksScope: monitors:read

List check results

Paramètres

  • iduuidpath · requis

    The monitor id.

  • sincedate-timequery · optionnel

    ISO date; defaults to the last 24 hours.

Exemple de requête

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

Exemple de réponse

[
  {
    "status": "up",
    "latencyMs": 138,
    "checkedAt": "2026-08-20T10:00:00.000Z"
  }
]

Ce que vous récupérez

  • GET /v1/monitors — la liste des moniteurs de votre équipe, chacun avec son type, sa cible, son état actuel (up, degraded ou down) et son pourcentage de disponibilité.
  • GET /v1/monitors/{id}/checks — les vérifications récentes d'un moniteur, pour tracer les temps de réponse ou reconstituer une chronologie.

Les types de moniteurs couvrent HTTP, TCP/port, ping, DNS, certificat SSL et mot-clé. Voir les types de moniteurs pour ce que chacun mesure et l'état des moniteurs pour savoir comment up / degraded / down sont déterminés.

Fréquence de sondage

Alignez votre fréquence de sondage sur l'intervalle de vérification du moniteur : lire les vérifications plus souvent qu'elles ne sont produites ne fait que consommer votre budget de limite de débit.

Exemple

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

Pour lire l'historique de vérifications d'un moniteur, reprenez un id de cette liste :

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

Remarques

  • Les valeurs CPU, RAM et disque sont des métriques de ressources remontées par l'agent du serveur, elles ne font pas partie du payload de vérification d'un moniteur.
  • Un 403 signifie que votre jeton n'a pas le scope monitors:read — voir les erreurs pour la liste complète des codes de statut.

Voir aussi

API IncidentsAutomatisez la création et les mises à jour d'incidents.API Pages de statutLisez vos pages de statut publiques.ScopesN'accordez que l'accès nécessaire à un jeton.Limites de débitRestez sous le budget de requêtes.
PrécédentServeursSuivantIncidents