Status
← Volver al estado actual

API de estado

Todos los datos de esta página de estado también están disponibles en JSON, de modo que puede integrar el estado de seven.io en sus propios paneles, sistemas de monitorización o widgets de estado.

Los endpoints son públicos, no requieren autenticación y permiten solicitudes cross-origin (Access-Control-Allow-Origin: *). Todas las marcas de tiempo son ISO 8601 en UTC.

Estado actual

GEThttps://status.seven.io/api/v1/statusDevuelve el estado global junto con todos los componentes y grupos de componentes.
{
  "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"
    }
  ]
}

El campo status del nivel superior es el peor estado de todos los componentes. components.groupId hace referencia a groups.id y position define el orden de visualización.

Valores posibles para status: operational, degraded_performance, partial_outage, major_outage, under_maintenance

Incidencias y mantenimientos

GEThttps://status.seven.io/api/v1/incidentsDevuelve las 20 entradas más recientes, empezando por la más nueva, cada una con todas sus actualizaciones y los componentes afectados.
[
  {
    "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" }
    ]
  }
]

Valores posibles para type: incident, maintenance

Valores posibles para status: investigating, identified, monitoring, resolved, scheduled, in_progress

Valores posibles para impact: none, minor, major, critical

Con type = maintenance se rellenan scheduledFor y scheduledUntil; en las incidencias son null. resolvedAt se rellena en cuanto la entrada se cierra.

Métricas

GEThttps://status.seven.io/api/v1/metrics?range=dayDevuelve todas las métricas mostradas en la página de estado junto con sus puntos de medición del periodo seleccionado.
[
  {
    "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" }
    ]
  }
]

Valores posibles para range (por defecto: day): day, week, month

Use offset para retroceder en el tiempo: offset=1 devuelve el periodo anterior (por ejemplo ayer con range=day), offset=2 el previo a ese, etc. Los puntos se conservan 31 días, por lo que se puede retroceder como máximo 30 días o 3 semanas; month solo admite offset=0.

Los puntos están agregados: intervalos de 5 minutos para day, de una hora para week y de un día para month, cada uno como percentil 95 suavizado. suffix es la unidad de visualización (por ejemplo ms), mientras que displayMin y displayMax son límites de eje opcionales y pueden ser null.

Feeds

También hay feeds Atom y RSS si prefiere recibir avisos de nuevas entradas.

/history.atom/history.rss

Notas

  • No analice el HTML de esta página de estado. Utilice los endpoints JSON, su estructura se mantiene estable.
  • Las respuestas no se almacenan en caché. Consultar una vez por minuto es suficiente para la mayoría de los casos.
  • Pueden añadirse campos nuevos en cualquier momento. Ignore los campos desconocidos en lugar de depender de una lista fija.