Riferimento API

REST API di live24h

L’API di live24h vi consente l’accesso programmatico a tutte le funzionalità della piattaforma. L’API è disponibile a partire dal piano Business.

Autenticazione

Tutte le richieste API richiedono una API key nell’header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.live24h.eu/v1/checks

Troverete la vostra API key nelle impostazioni dell’account alla voce Accesso API.

URL base

https://api.live24h.eu/v1/

Endpoint

Controlli

Metodo	Endpoint	Descrizione
`GET`	`/checks`	Elencare tutti i controlli
`POST`	`/checks`	Creare un nuovo controllo
`GET`	`/checks/{id}`	Ottenere dettagli del controllo
`PUT`	`/checks/{id}`	Aggiornare un controllo
`DELETE`	`/checks/{id}`	Eliminare un controllo
`GET`	`/checks/{id}/history`	Ottenere la cronologia del controllo

Status Pages

Metodo	Endpoint	Descrizione
`GET`	`/status-pages`	Elencare tutte le Status Pages
`POST`	`/status-pages`	Creare una nuova Status Page
`GET`	`/status-pages/{id}`	Dettagli della Status Page

Incidenti

Metodo	Endpoint	Descrizione
`GET`	`/incidents`	Elencare tutti gli incidenti
`POST`	`/incidents`	Creare un incidente
`PUT`	`/incidents/{id}`	Aggiornare un incidente

Esempio: Creare un controllo

curl -X POST https://api.live24h.eu/v1/checks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Il mio sito web",
    "url": "https://www.example.com",
    "type": "http",
    "interval": 60,
    "alertChannels": ["email"]
  }'

Formato della risposta

Tutte le risposte vengono restituite in formato JSON:

{
  "data": {
    "id": "chk_abc123",
    "name": "Il mio sito web",
    "url": "https://www.example.com",
    "status": "up",
    "lastCheckedAt": "2025-01-15T10:30:00Z",
    "responseTime": 245
  }
}

Rate Limiting

L’API è limitata a 100 richieste al minuto. In caso di superamento, riceverete uno stato 429 Too Many Requests.

Gestione degli errori

Stato	Significato
`400`	Richiesta non valida
`401`	Autenticazione mancante o non valida
`404`	Risorsa non trovata
`429`	Limite di frequenza superato
`500`	Errore interno del server