dm_check — API Reference

Checks

GET /api/checks Lista tutti i check con stato corrente

Response

[
  {
    "id":               "dmdesk",
    "name":             "DmDesk CMS",
    "url":              "https://desk-robin.cloud.atex.com/desk/#/",
    "type":             "HTTPS",
    "status":           "ok",        // "ok" | "ko" | "unknown"
    "phase":            3,
    "uptime_pct":       99.2,
    "last_response_ms": 4821,
    "last_checked_at":  "2026-05-03T10:00:00.000Z",
    "last_root_cause":  null,
    "last_ts":          1746266400000,
    "last_phase_data":  { "navigate_ms": 1200, "login_ms": 3800 }
  }
]

GET /api/checks/:id/history Storico risultati di un check

Path params

Param	Tipo	Descrizione
id req	string	ID del check (es. `dmdesk`, `video-encoding`)

Query params

Param	Tipo	Default	Descrizione
days opt	integer	7	Giorni di storico (max 30)

Response

[
  {
    "id":          1234,
    "check_id":    "dmdesk",
    "status":      "ok",
    "phase":       3,
    "response_ms": 4821,
    "root_cause":  null,
    "phase_data":  "{\"navigate_ms\":1200}",
    "ts":          1746266400000
  }
]

POST /api/checks/:id/run Esegui un check manualmente

Path params

Param	Tipo	Descrizione
id req	string	ID del check

Response

{
  "status":      "ok",
  "phase":       3,
  "response_ms": 4821,
  "root_cause":  null,
  "ts":          1746266400000
}

GET /test/:id Risultato rapido dell'ultimo check (cache in memoria)

Response

{
  "status":      "OK",         // "OK" | "KO" | "PENDING"
  "phase":       3,
  "response_ms": 4821,
  "root_cause":  null,
  "checked_at":  "2026-05-03T10:00:00.000Z"
}

Restituisce 202 PENDING se il check non è ancora stato eseguito dall'avvio del server.

GET /api/health Health check del server

Response

{ "ok": true, "uptime": 3600.5 }

Status Page

GET /api/status Stato aggregato per la status page pubblica (90 giorni)

Response

{
  "global":     "operational",  // "operational" | "outage"
  "updated_at": "2026-05-03T10:00:00.000Z",
  "services": [
    {
      "id":             "dmdesk",
      "name":           "DmDesk CMS",
      "status":         "operational",
      "uptime_30d":     99.85,
      "uptime_90d":     99.71,
      "last_checked_at": "2026-05-03T10:00:00.000Z",
      "daily":          [ { "date": "2026-05-03", "ok": 288, "total": 288, "pct": 100 } ],
      "incidents":      []
    }
  ]
}

GET /api/external/dailymotion-status Proxy per lo stato ufficiale Dailymotion (evita CORS)

Response

{ "indicator": "none", "description": "All Systems Operational" }

indicator: none = tutto ok · minor · major · critical

Alert Log

GET /api/alerts/log Ultimi alert inviati (Telegram + Push)

Query params

Param	Tipo	Default	Descrizione
limit opt	integer	50	Numero massimo di righe (max 100)

Response

[
  {
    "id":       42,
    "check_id": "dmdesk",
    "channel":  "telegram",   // "telegram" | "push"
    "event":    "down",        // "down" | "up"
    "payload":  "Timeout fase 2",
    "sent_at":  1746266400000
  }
]

GET /api/telegram Stato configurazione Telegram

Response

{ "configured": true, "chat_id": "-100123456789", "verified": true }

POST /api/telegram/setup Configura bot Telegram

Body (JSON)

Campo	Tipo	Descrizione
bot_token req	string	Token del bot Telegram
chat_id req	string	ID del gruppo o canale destinatario

POST /api/telegram/verify Invia messaggio di test e marca come verificato

Nessun body richiesto. Restituisce {"ok": true} se il messaggio è stato inviato.

DELETE /api/telegram Rimuove la configurazione Telegram

Nessun body richiesto. Restituisce {"ok": true}.

Push Notifications

GET /api/push/vapid-public-key Chiave pubblica VAPID per la registrazione push

Response

{ "key": "BNx8..." }

Se la variabile VAPID_PUBLIC_KEY non è configurata, key sarà null.

POST /api/push/subscribe Registra una sottoscrizione push

Body (JSON)

Campo	Tipo	Descrizione
endpoint req	string	URL endpoint push del browser
keys.p256dh req	string	Chiave pubblica del client
keys.auth req	string	Secret di autenticazione
label opt	string	Etichetta per identificare il dispositivo

DELETE /api/push/unsubscribe Rimuove una sottoscrizione push

Body (JSON)

Campo	Tipo	Descrizione
endpoint req	string	URL endpoint da rimuovere

Chatbot

POST /api/chat Invia una domanda all'assistente AI

Body (JSON)

Campo	Tipo	Descrizione
question req	string	Testo della domanda
session_id opt	string	ID sessione per tracciare il feedback

Response

{
  "answer": "DmDesk CMS è attualmente operativo...",
  "source": "ai"   // "ai" | "cache" | "error"
}

POST /api/chatbot/feedback Invia feedback su una risposta AI

Body (JSON)

Campo	Tipo	Descrizione
question req	string	Domanda originale
ai_answer req	string	Risposta AI ricevuta
session_id opt	string	ID sessione
rating opt	integer	Valutazione (es. 1 = positivo, -1 = negativo)
correction opt	string	Testo correttivo fornito dall'utente

GET /api/chatbot/qa Lista voci della knowledge base

Query params

Param	Tipo	Default	Descrizione
approved opt	0 \| 1	0	Se `1`, restituisce solo le voci approvate

Response

[
  {
    "id":       1,
    "question": "Cosa fare se DmDesk è down?",
    "answer":   "Procedura intervento...",
    "source":   "runbook",  // "ai" | "manual" | "runbook"
    "approved": 1,
    "ts":       1746266400000
  }
]

POST /api/chatbot/qa Aggiunge manualmente una voce alla knowledge base

Body (JSON)

Campo	Tipo	Descrizione
question req	string	Domanda
answer req	string	Risposta
approved opt	boolean	Approva immediatamente (default: false)

POST /api/chatbot/qa/:id/approve Approva una voce Q&A (la rende attiva nel system prompt)

Nessun body. Restituisce {"ok": true}.

DELETE /api/chatbot/qa/:id Elimina una voce Q&A dalla knowledge base

Nessun body. Restituisce {"ok": true}.

Check ID di riferimento

ID	Nome	Frequenza
`dmdesk`	DmDesk CMS	ogni 5 min
`frontpage`	DmDesk Frontpage	ogni 5 min
`desk-agenzie`	DmDesk Agenzie	ogni 5 min
`article-preview`	DmDesk Article Preview	ogni 10 min
`video-encoding`	DmDesk Video Encoding	ogni 10 min
`dailymotion`	Dailymotion Status	ogni 5 min