API de statut

Toutes les données de cette page de statut sont également disponibles en JSON. Vous pouvez ainsi intégrer l'état de seven.io dans vos propres tableaux de bord, systèmes de supervision ou widgets de statut.

Les points de terminaison sont publics, ne nécessitent aucune authentification et autorisent les requêtes cross-origin (Access-Control-Allow-Origin: *). Tous les horodatages sont au format ISO 8601 en UTC.

Statut actuel

GEThttps://status.seven.io/api/v1/statusRenvoie le statut global ainsi que tous les composants et groupes de composants.

{
  "status": "operational",
  "components": [
    {
      "id": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
      "name": "SMS Gateway",
      "description": "SMS sending and delivery",
      "status": "operational",
      "position": 0,
      "groupId": "9f8e7d6c-5b4a-3210-fedc-ba9876543210",
      "showUptime": true,
      "lastCheckAt": "2026-08-25T09:12:00.000Z",
      "createdAt": "2025-01-08T10:00:00.000Z"
    }
  ],
  "groups": [
    {
      "id": "9f8e7d6c-5b4a-3210-fedc-ba9876543210",
      "name": "Messaging",
      "description": null,
      "position": 0,
      "createdAt": "2025-01-08T10:00:00.000Z"
    }
  ]
}

Le champ status à la racine correspond au pire statut de tous les composants. components.groupId renvoie à groups.id, et position définit l'ordre d'affichage.

Valeurs possibles pour status : operational, degraded_performance, partial_outage, major_outage, under_maintenance

Incidents et maintenances

GEThttps://status.seven.io/api/v1/incidentsRenvoie les 20 dernières entrées, les plus récentes en premier, avec toutes leurs mises à jour et les composants concernés.

[
  {
    "id": "1122aabb-ccdd-4eef-8899-001122334455",
    "type": "incident",
    "title": "Delayed SMS delivery",
    "status": "resolved",
    "impact": "minor",
    "autoCreated": false,
    "scheduledFor": null,
    "scheduledUntil": null,
    "postmortemBody": null,
    "postmortemPublishedAt": null,
    "createdAt": "2026-08-20T08:30:00.000Z",
    "updatedAt": "2026-08-20T09:45:00.000Z",
    "resolvedAt": "2026-08-20T09:45:00.000Z",
    "updates": [
      {
        "id": "5566ddee-7788-4aab-9900-aabbccddeeff",
        "incidentId": "1122aabb-ccdd-4eef-8899-001122334455",
        "status": "resolved",
        "body": "Delivery is back to normal.",
        "createdAt": "2026-08-20T09:45:00.000Z"
      }
    ],
    "affectedComponents": [
      { "id": "0a1b2c3d-4e5f-6789-abcd-ef0123456789", "name": "SMS Gateway" }
    ]
  }
]

Valeurs possibles pour type : incident, maintenance

Valeurs possibles pour status : investigating, identified, monitoring, resolved, scheduled, in_progress

Valeurs possibles pour impact : none, minor, major, critical

Pour type = maintenance, scheduledFor et scheduledUntil sont renseignés ; pour les incidents, ils valent null. resolvedAt est renseigné dès que l'entrée est clôturée.

Métriques

GEThttps://status.seven.io/api/v1/metrics?range=dayRenvoie toutes les métriques affichées sur la page de statut, avec leurs points de mesure pour la période sélectionnée.

[
  {
    "id": "aabbccdd-1122-4334-9556-778899aabbcc",
    "name": "SMS API response time",
    "suffix": "ms",
    "position": 0,
    "displayMin": 0,
    "displayMax": null,
    "createdAt": "2025-01-08T10:00:00.000Z",
    "points": [
      { "value": 128.4, "timestamp": "2026-08-25T09:00:00.000Z" },
      { "value": 131.7, "timestamp": "2026-08-25T09:05:00.000Z" }
    ]
  }
]

Valeurs possibles pour range (par défaut : day) : day, week, month

Utilisez offset pour remonter dans le temps : offset=1 renvoie la période précédente (par exemple hier pour range=day), offset=2 celle d'avant, etc. Les points de mesure sont conservés 31 jours, il est donc possible de remonter au maximum 30 jours ou 3 semaines ; month ne prend en charge que offset=0.

Les points de mesure sont agrégés : intervalles de 5 minutes pour day, d'une heure pour week et d'un jour pour month, chacun sous forme de 95e centile lissé. suffix est l'unité d'affichage (par exemple ms), tandis que displayMin et displayMax sont des bornes d'axe facultatives pouvant valoir null.

Flux

Des flux Atom et RSS sont également disponibles pour être informé des nouvelles entrées.

/history.atom /history.rss

Remarques

Merci de ne pas analyser le HTML de cette page de statut. Utilisez les points de terminaison JSON, leur structure reste stable.
Les réponses ne sont pas mises en cache. Une interrogation par minute suffit dans la plupart des cas.
De nouveaux champs peuvent être ajoutés à tout moment. Ignorez les champs inconnus plutôt que de vous appuyer sur une liste figée.