REST API de live24h
La API de live24h le permite acceder programáticamente a todas las funciones de la plataforma. La API está disponible a partir del plan Business.
Autenticación
Todas las solicitudes a la API requieren una API Key en el header:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.live24h.eu/v1/checks
Encontrará su API Key en la configuración de su cuenta en Acceso API.
URL base
https://api.live24h.eu/v1/
Endpoints
Checks
| Método | Endpoint | Descripción |
|---|---|---|
GET | /checks | Listar todos los checks |
POST | /checks | Crear un nuevo check |
GET | /checks/{id} | Obtener detalles del check |
PUT | /checks/{id} | Actualizar check |
DELETE | /checks/{id} | Eliminar check |
GET | /checks/{id}/history | Obtener historial del check |
Status Pages
| Método | Endpoint | Descripción |
|---|---|---|
GET | /status-pages | Listar todas las Status Pages |
POST | /status-pages | Crear nueva Status Page |
GET | /status-pages/{id} | Detalles de Status Page |
Incidents
| Método | Endpoint | Descripción |
|---|---|---|
GET | /incidents | Listar todos los incidentes |
POST | /incidents | Crear incidente |
PUT | /incidents/{id} | Actualizar incidente |
Ejemplo: Crear un check
curl -X POST https://api.live24h.eu/v1/checks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Mi sitio web",
"url": "https://www.example.com",
"type": "http",
"interval": 60,
"alertChannels": ["email"]
}'
Formato de respuesta
Todas las respuestas se devuelven en formato JSON:
{
"data": {
"id": "chk_abc123",
"name": "Mi sitio web",
"url": "https://www.example.com",
"status": "up",
"lastCheckedAt": "2025-01-15T10:30:00Z",
"responseTime": 245
}
}
Rate Limiting
La API está limitada a 100 solicitudes por minuto. Si se excede, recibirá un estado 429 Too Many Requests.
Manejo de errores
| Estado | Significado |
|---|---|
400 | Solicitud inválida |
401 | Autenticación faltante o inválida |
404 | Recurso no encontrado |
429 | Límite de solicitudes excedido |
500 | Error interno del servidor |