Disponibilidad
Crea comprobaciones de disponibilidad, lee su estado y sus resultados, y mira cuándo dejó de responder tu app.
En esta página
Una comprobación de disponibilidad es una petición que el motor le hace a una URL tuya cada cierto tiempo. Una comprobación queda down después de dos fallas seguidas y vuelve a up con un éxito. Caerse y volver crean, cada uno, una alerta.
Un motor alojado por ti comprueba desde donde corre, así que ve tu app desde un solo lugar. Sypnia Cloud comprueba desde tres regiones y da una comprobación por caída cuando al menos dos fallan.
El objeto comprobación de disponibilidad
Campos
-
idstring opcionalchk_…. -
namestring opcional -
urlURL opcional -
methodstring opcional -
interval_secondsinteger opcional -
timeout_msinteger opcional -
expected_statusstring opcional -
body_containsstring o null opcional -
headersobject opcional -
enabledboolean opcional -
statusstring opcionalunknownhasta que corre la primera comprobación. Uno de:up,down,paused,unknown. -
down_sincetimestamp o null opcionalLa primera falla de la caída actual.
-
last_checked_attimestamp o null opcional -
last_status_codeinteger o null opcionalEl estado HTTP de la última comprobación.
nullcuando no hubo respuesta. -
last_response_msinteger o null opcional -
last_errorstring o null opcionalPor qué falló la última comprobación:
timeout,dns,connection_refused,tls,status_503,body_mismatch. -
uptime_24hnumber o null opcionalPorcentaje de comprobaciones que pasaron en las últimas 24 horas.
-
uptime_30dnumber o null opcional -
created_attimestamp opcional
Listar comprobaciones de disponibilidad
/v1/uptime/checks MotorNube Todas las comprobaciones del proyecto con su estado actual. Es lo que devuelve la herramienta MCP uptime.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403. -
statusstring opcionalSolo comprobaciones en este estado. Uno de:
up,down,paused,unknown. -
limitinteger, 1 a 200 opcionalMáximo de elementos que se devuelven.
Por defecto:
50 -
cursorstring opcionalEl
next_cursorde la página anterior. Deja iguales todos los demás parámetros.
Petición
curl "https://api.sypnia.com/v1/uptime/checks" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"data": [
{
"id": "chk_1q9w3e7r5t2y",
"name": "Shop home",
"url": "https://shop.example.com/",
"method": "GET",
"interval_seconds": 60,
"timeout_ms": 10000,
"expected_status": "200-399",
"body_contains": null,
"headers": {},
"enabled": true,
"status": "up",
"down_since": null,
"last_checked_at": "2026-03-12T10:34:00Z",
"last_status_code": 200,
"last_response_ms": 184,
"last_error": null,
"uptime_24h": 100,
"uptime_30d": 99.98,
"created_at": "2026-02-02T09:20:00Z"
}
],
"next_cursor": null
}Crear una comprobación de disponibilidad
/v1/uptime/checks MotorNube Empieza a comprobar una URL. La primera comprobación corre en menos de un minuto. El motor envía el encabezado User-Agent: Sypnia-Uptime/1.0, sigue hasta 3 redirecciones y nunca envía cookies. Solo se permiten URLs http y https en direcciones públicas: una URL que resuelve a una dirección privada o local se rechaza, para que una comprobación no sirva para entrar a tu propia red.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Encabezados
-
Idempotency-Keystring, hasta 255 caracteres opcionalUn valor tuyo, de 1 a 255 caracteres, que hace que la llamada se pueda repetir sin riesgo. Mira idempotencia.
Cuerpo
-
namestring, hasta 80 caracteres opcionalUn nombre para las personas. Obligatorio al crear.
-
urlURL, hasta 2,000 caracteres opcionalLa URL que se pide. Obligatoria al crear.
-
methodstring opcionalEl método HTTP. Uno de:
GET,HEAD.Por defecto:
GET -
interval_secondsinteger opcionalCada cuánto comprobar. Uno de:
60,300,900.Por defecto:
60 -
timeout_msinteger, 1,000 a 30,000 opcionalUna respuesta más lenta que esto es una falla.
Por defecto:
10000 -
expected_statusstring opcionalLos estados que cuentan como arriba: uno (
200), un rango (200-299) o una lista (200,204,301).Por defecto:
200-399 -
body_containsstring, hasta 200 caracteres o null opcionalTexto que debe traer el cuerpo de la respuesta para contar como arriba. Solo con
GET. El motor lee los primeros 256 KB. -
headersobject opcionalHasta 10 encabezados de la petición. Se guardan y se devuelven tal como los envías, así que no pongas secretos aquí.
-
enabledboolean opcionalfalsepausa la comprobación.Por defecto:
true
Petición
curl -X POST "https://api.sypnia.com/v1/uptime/checks" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Shop home", "url": "https://shop.example.com/"}'Respuesta201
{
"id": "chk_1q9w3e7r5t2y",
"name": "Shop home",
"url": "https://shop.example.com/",
"method": "GET",
"interval_seconds": 60,
"timeout_ms": 10000,
"expected_status": "200-399",
"body_contains": null,
"headers": {},
"enabled": true,
"status": "unknown",
"down_since": null,
"last_checked_at": null,
"last_status_code": null,
"last_response_ms": null,
"last_error": null,
"uptime_24h": null,
"uptime_30d": null,
"created_at": "2026-02-02T09:20:00Z"
}Errores
- 400
invalid_requestLa URL no es
httpnihttps, resuelve a una dirección privada, o un campo está fuera de rango.paramnombra el campo. - 409
limit_reachedEl proyecto ya tiene tantas comprobaciones como permite su plan (Sypnia Cloud), o como permite
SYPNIA_QUOTA_UPTIME_CHECKS(motor).
Traer una comprobación de disponibilidad
/v1/uptime/checks/{check_id} MotorNube Una comprobación con su estado actual.
Parámetros de ruta
-
check_idstring obligatorioEl id de la comprobación (
chk_…).
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Petición
curl "https://api.sypnia.com/v1/uptime/checks/chk_1q9w3e7r5t2y" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"id": "chk_1q9w3e7r5t2y",
"name": "Shop home",
"url": "https://shop.example.com/",
"method": "GET",
"interval_seconds": 60,
"timeout_ms": 10000,
"expected_status": "200-399",
"body_contains": null,
"headers": {},
"enabled": true,
"status": "up",
"down_since": null,
"last_checked_at": "2026-03-12T10:34:00Z",
"last_status_code": 200,
"last_response_ms": 184,
"last_error": null,
"uptime_24h": 100,
"uptime_30d": 99.98,
"created_at": "2026-02-02T09:20:00Z"
}Errores
- 404
not_foundNinguna comprobación del proyecto tiene este id.
Actualizar una comprobación de disponibilidad
/v1/uptime/checks/{check_id} MotorNube Cambia los campos que envías y deja los demás. Pon enabled en false para pausar una comprobación; una comprobación pausada tiene estado paused y no crea alertas.
Parámetros de ruta
-
check_idstring obligatorioEl id de la comprobación (
chk_…).
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Cuerpo
-
namestring, hasta 80 caracteres opcionalUn nombre para las personas. Obligatorio al crear.
-
urlURL, hasta 2,000 caracteres opcionalLa URL que se pide. Obligatoria al crear.
-
methodstring opcionalEl método HTTP. Uno de:
GET,HEAD.Por defecto:
GET -
interval_secondsinteger opcionalCada cuánto comprobar. Uno de:
60,300,900.Por defecto:
60 -
timeout_msinteger, 1,000 a 30,000 opcionalUna respuesta más lenta que esto es una falla.
Por defecto:
10000 -
expected_statusstring opcionalLos estados que cuentan como arriba: uno (
200), un rango (200-299) o una lista (200,204,301).Por defecto:
200-399 -
body_containsstring, hasta 200 caracteres o null opcionalTexto que debe traer el cuerpo de la respuesta para contar como arriba. Solo con
GET. El motor lee los primeros 256 KB. -
headersobject opcionalHasta 10 encabezados de la petición. Se guardan y se devuelven tal como los envías, así que no pongas secretos aquí.
-
enabledboolean opcionalfalsepausa la comprobación.Por defecto:
true
Petición
curl -X PATCH "https://api.sypnia.com/v1/uptime/checks/chk_1q9w3e7r5t2y" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"interval_seconds": 300, "body_contains": "Add to cart"}'Respuesta200
{
"id": "chk_1q9w3e7r5t2y",
"name": "Shop home",
"url": "https://shop.example.com/",
"method": "GET",
"interval_seconds": 300,
"timeout_ms": 10000,
"expected_status": "200-399",
"body_contains": "Add to cart",
"headers": {},
"enabled": true,
"status": "up",
"down_since": null,
"last_checked_at": "2026-03-12T10:33:00Z",
"last_status_code": 200,
"last_response_ms": 184,
"last_error": null,
"uptime_24h": 100,
"uptime_30d": 99.98,
"created_at": "2026-02-02T09:20:00Z"
}Errores
- 400
invalid_requestUn campo está fuera de rango.
paramlo nombra. - 404
not_foundNinguna comprobación del proyecto tiene este id.
Borrar una comprobación de disponibilidad
/v1/uptime/checks/{check_id} MotorNube Detiene la comprobación y borra sus resultados. Las alertas que creó se quedan.
Parámetros de ruta
-
check_idstring obligatorioEl id de la comprobación (
chk_…).
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Petición
curl -X DELETE "https://api.sypnia.com/v1/uptime/checks/chk_1q9w3e7r5t2y" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"Errores
- 404
not_foundNinguna comprobación del proyecto tiene este id.
Traer los resultados de una comprobación
/v1/uptime/checks/{check_id}/results MotorNube La historia de la comprobación: un intervalo por hora con cuántas comprobaciones corrieron, cuántas fallaron y cuánto tardaron las respuestas, más las caídas, cada tramo en el que la comprobación estuvo abajo. Los resultados sueltos se guardan 7 días y los intervalos por hora 400 días.
Parámetros de ruta
-
check_idstring obligatorioEl id de la comprobación (
chk_…).
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403. -
sincestring opcionalInicio del periodo.
Por defecto:
24h -
untilstring opcionalFin del rango de tiempo. Una fecha ISO 8601 o un valor relativo. Por defecto, ahora.
Petición
curl "https://api.sypnia.com/v1/uptime/checks/chk_1q9w3e7r5t2y/results?since=3h" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"check_id": "chk_1q9w3e7r5t2y",
"uptime": 99.44,
"buckets": [
{
"start": "2026-03-12T08:00:00Z",
"checks": 60,
"failures": 0,
"avg_ms": 181,
"p95_ms": 240
},
{
"start": "2026-03-12T09:00:00Z",
"checks": 60,
"failures": 1,
"avg_ms": 190,
"p95_ms": 262
},
{
"start": "2026-03-12T10:00:00Z",
"checks": 33,
"failures": 0,
"avg_ms": 184,
"p95_ms": 251
}
],
"incidents": []
}Errores
- 404
not_foundNinguna comprobación del proyecto tiene este id.
Los errores que cualquier endpoint puede responder (401, 403, 429, 500, 503) están en Errores, límites, paginación.