API REST live24h
L’API live24h vous permet d’accéder de manière programmatique à toutes les fonctionnalités de la plateforme. L’API est disponible à partir du tarif Business.
Authentification
Toutes les requêtes API nécessitent une clé API dans le header :
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.live24h.eu/v1/checks
Vous trouverez votre clé API dans les paramètres de votre compte sous Accès API.
URL de base
https://api.live24h.eu/v1/
Endpoints
Checks
| Méthode | Endpoint | Description |
|---|---|---|
GET | /checks | Lister tous les checks |
POST | /checks | Créer un nouveau check |
GET | /checks/{id} | Obtenir les détails d’un check |
PUT | /checks/{id} | Mettre à jour un check |
DELETE | /checks/{id} | Supprimer un check |
GET | /checks/{id}/history | Obtenir l’historique d’un check |
Status Pages
| Méthode | Endpoint | Description |
|---|---|---|
GET | /status-pages | Lister toutes les status pages |
POST | /status-pages | Créer une nouvelle status page |
GET | /status-pages/{id} | Détails d’une status page |
Incidents
| Méthode | Endpoint | Description |
|---|---|---|
GET | /incidents | Lister tous les incidents |
POST | /incidents | Créer un incident |
PUT | /incidents/{id} | Mettre à jour un incident |
Exemple : Créer un check
curl -X POST https://api.live24h.eu/v1/checks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Mon site web",
"url": "https://www.example.com",
"type": "http",
"interval": 60,
"alertChannels": ["email"]
}'
Format de réponse
Toutes les réponses sont renvoyées au format JSON :
{
"data": {
"id": "chk_abc123",
"name": "Mon site web",
"url": "https://www.example.com",
"status": "up",
"lastCheckedAt": "2025-01-15T10:30:00Z",
"responseTime": 245
}
}
Rate Limiting
L’API est limitée à 100 requêtes par minute. En cas de dépassement, vous recevrez un statut 429 Too Many Requests.
Gestion des erreurs
| Statut | Signification |
|---|---|
400 | Requête invalide |
401 | Authentification manquante ou invalide |
404 | Ressource introuvable |
429 | Limite de requêtes dépassée |
500 | Erreur interne du serveur |