<!-- source_url: https://docs.mynexusapi.com/v1/guias/estado-del-servicio | last_updated: 2026-11-13 -->

# Estado del servicio

Consulta sin API Key si la API está operativa, su disponibilidad de los últimos 90 días y los incidentes publicados, en JSON o en la página de estado.

Cuando tu integración empieza a recibir errores `5xx` o tiempos de espera, lo primero que conviene saber es si el problema está en tu sistema o en el servicio. Para eso publicamos el estado de la API de forma abierta: no necesitas una API Key y puedes leerlo en la [página de estado](/v1/estado) o con una petición `GET /estado` desde tus propias alertas.

Esta guía explica qué devuelve la consulta, cómo interpretar cada estado, con qué frecuencia puedes consultarla y qué hacer en tu integración cuando el servicio está degradado o caído.

## Endpoint

```text
GET https://api.mynexusapi.com/estado
```

La ruta no lleva el prefijo `/v1`, no requiere la cabecera `X-Api-Key` y no recibe parámetros.

## Cuándo usarlo

- Para mostrar el estado de la facturación en el panel de soporte de tu sistema.
- Para decidir si pausas un proceso masivo cuando la API no está operativa y reanudarlo cuando vuelva a estarlo.
- Para alimentar tus propias alertas sin gastar el [límite de solicitudes](/v1/guias/limite-de-request) de tu integración, porque esta consulta no usa tu API Key.

Si quieres comprobar solamente que el servicio responde, `GET /salud` responde 200 con el estado `activo`. Para conocer el detalle de la disponibilidad y los incidentes, usa `GET /estado`.

## Ejemplo

```bash
curl -s "https://api.mynexusapi.com/estado"
```

```csharp
using System.Net.Http;

using var http = new HttpClient { BaseAddress = new Uri("https://api.mynexusapi.com") };

using HttpResponseMessage respuesta = await http.GetAsync("/estado");
Console.WriteLine($"{(int)respuesta.StatusCode} {await respuesta.Content.ReadAsStringAsync()}");
```

```javascript
// Node.js 18 o superior. Guarda como estado.mjs y ejecuta: node estado.mjs
const res = await fetch('https://api.mynexusapi.com/estado');
console.log(res.status, await res.text());
```

```php
<?php
$ch = curl_init('https://api.mynexusapi.com/estado');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$cuerpo = curl_exec($ch);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $estado . ' ' . $cuerpo . PHP_EOL;
```

```bash-cli
# Resultado esperado: el estado del servicio y su disponibilidad de los últimos 90 días.
ecuafact estado-servicio
```

## Respuesta

La respuesta es `200 OK` aunque el servicio esté degradado o caído: el estado va en el cuerpo.

```json
{
  "estado": "operativo",
  "medidoEn": "2026-11-16T14:32:10Z",
  "componentes": [
    {
      "nombre": "Ecuafact API",
      "estado": "operativo"
    }
  ],
  "disponibilidad90Dias": 99.97,
  "incidentes": [
    {
      "inicio": "2026-11-02T09:10:00Z",
      "fin": "2026-11-02T09:42:00Z",
      "impacto": "degradado",
      "titulo": "Respuestas lentas en la emisión",
      "detalle": "La emisión tardó más de lo habitual. No se perdió ningún comprobante."
    }
  ]
}
```

| Campo | Tipo | Descripción |
|---|---|---|
| `estado` | string | Estado general del servicio. Puede ser `operativo`, `degradado`, `caido` o `sin_datos`. |
| `medidoEn` | string o `null` | Momento de la última medición, en formato ISO 8601 (UTC). Es `null` si todavía no hay mediciones. |
| `componentes` | array | Componentes monitoreados, cada uno con `nombre` y `estado`. El servicio publica un único componente, `Ecuafact API`. |
| `disponibilidad90Dias` | number o `null` | Porcentaje de minutos sin caída en los últimos 90 días. Es `null` si todavía no hay muestras. |
| `incidentes` | array | Incidentes de los últimos 90 días y los que siguen abiertos, del más reciente al más antiguo. Es una lista vacía si no hubo ninguno. |
| `incidentes[].inicio` | string | Inicio del incidente, en formato ISO 8601 (UTC). |
| `incidentes[].fin` | string | Fin del incidente. Se omite mientras el incidente sigue abierto. |
| `incidentes[].impacto` | string | `degradado` o `caido`. |
| `incidentes[].titulo` | string | Título breve del incidente. |
| `incidentes[].detalle` | string | Qué significó el incidente para tus integraciones. Se omite si no hay detalle. |

### Valores de `estado`

| Valor | Significado | Qué hacer |
|---|---|---|
| `operativo` | El servicio responde con normalidad. | No hagas nada. |
| `degradado` | El servicio responde, pero con lentitud o con errores en algunas peticiones. | Reintenta con espera, como se explica en [Buenas prácticas](/v1/guias/buenas-practicas#reintentos-con-espera-exponencial), y vigila el incidente publicado. |
| `caido` | El servicio no está disponible. | Pausa los envíos masivos y reintenta más tarde. |
| `sin_datos` | No hay una medición reciente. No significa que el servicio esté caído. | Consulta de nuevo en un minuto. Si persiste, revisa la [página de estado](/v1/estado) o escribe a soporte con el `X-Correlation-Id` de tu petición. |

La disponibilidad se mide sobre la aceptación de los comprobantes. La autorización del SRI es una dependencia externa que puede tardar o fallar sin que la API esté caída; en ese caso el comprobante queda `recibido` y sigue su curso, como se explica en [Ciclo de vida del comprobante](/v1/guias/ciclo-de-vida).

## Límites de la consulta

- Cada IP puede consultar `GET /estado` hasta 60 veces por minuto. Para alertas propias basta con una consulta por minuto.
- La respuesta se puede guardar hasta 30 segundos: llega con `Cache-Control: public, max-age=30`.

Si superas el límite, la API responde 429 con el `codEstado` 5005 (`limite_solicitudes`) y la cabecera `Retry-After` con los segundos de espera.

```json
{
  "estado": "rechazado",
  "codEstado": 5005,
  "msgError": "Demasiadas solicitudes. Reintenta en un minuto.",
  "errores": []
}
```

## Estados de este endpoint

| Código | HTTP | Cuándo ocurre | Qué hacer |
|---|---|---|---|
| 5005 (`limite_solicitudes`) | 429 | Tu IP superó las consultas por minuto permitidas. | Espera los segundos que indica `Retry-After` y consulta de nuevo. |

## Siguientes pasos

- [Continuidad y salida](/v1/guias/continuidad-y-salida): qué pasa con tus comprobantes y tu cupo cuando el servicio tiene un incidente.
- [Buenas prácticas](/v1/guias/buenas-practicas): cómo reintentar sin duplicar comprobantes.
- [Errores](/v1/guias/errores): qué significan los errores 5xx y cuáles se reintentan.
