Outbreak Tracker

Public API

Endpoint JSON read-only del tracker outbreak hantavirus MV Hondius. Free, no auth, no rate limit (oltre il fair use Cloudflare). Aggiornati ogni 6h dalla pipeline AI.

Endpoints

Case tracking v2 — endpoints (sperimentali)

v2 sperimentale: tracciamento individuale dei casi con timeline persona-per-persona, costruito via LLM (Mistral profile_builder + Sonnet case_linker). Schema in fase di stabilizzazione. Contagiati ed esposti restano tenuti separati nei conteggi: gli esposti sono passeggeri evacuati/trasferiti di cui non è noto lo stato clinico, non casi sospetti.

Esempi d'uso

curl / shell

curl -s https://outbreak-monitor.com/api/v1/events.json | jq '.[0]'

# Filtra solo eventi verified
curl -s https://outbreak-monitor.com/api/v1/events.json | \
  jq '.[] | select(.verification_status == "verified")'

Python

import requests

events = requests.get("https://outbreak-monitor.com/api/v1/events.json").json()
deaths = [e for e in events if e["category"] == "death"]
print(f"{len(deaths)} death events tracked")

JavaScript (fetch)

fetch("https://outbreak-monitor.com/api/v1/snapshots.json")
  .then(r => r.json())
  .then(snapshots => {
    const latest = snapshots
      .filter(s => s.scope === "cruise_ship")
      .sort((a, b) => b.date.localeCompare(a.date))[0];
    console.log("Latest WHO total:", latest.totals);
  });

Node.js / Python data science

import pandas as pd
df = pd.read_json("https://outbreak-monitor.com/api/v1/events.json")
df.groupby("source_authority").size()

Schema events.json

Caching & freshness

• Cache HTTP max-age=300 (5 min). Cloudflare CDN davanti.
• Pipeline aggiorna i JSON ogni 6 ore.
• Per polling efficiente, leggi il header last-modified e usa If-Modified-Since.

Limiti

• Solo metodi GET e OPTIONS (preflight CORS).
• Nessun parametro query: il dataset completo è restituito ad ogni richiesta — filtra lato client. Per dataset più grandi (futuri outbreak) considereremo paginazione.
• Fair use: non DDoS-are. Cloudflare blocca bot aggressivi automaticamente.
• CORS: configurato lato origin con Access-Control-Allow-Origin: *. Se il header non arriva (dipende dalle policy CDN attive), può essere necessario un proxy lato server.

Stabilità & versioning

URL /api/v1/ garantito stabile. In caso di breaking change schema, sarà rilasciato /api/v2/ mantenendo v1 per ≥6 mesi. Aggiornamenti additivi (nuovi campi opzionali) sono retrocompatibili e non incrementano la versione.

Widget embeddable

Per integrare il box "ufficiali vs media tracked" in un blog/articolo, basta un <iframe>:

<iframe src="https://outbreak-monitor.com/embed.html"
  width="480" height="280"
  frameborder="0" loading="lazy"
  title="Outbreak Tracker — Hantavirus MV Hondius">
</iframe>

Parametri:

Esempi:

<!-- Inglese, tema scuro -->
<iframe src="https://outbreak-monitor.com/embed.html?lang=en&theme=dark"
  width="480" height="280" frameborder="0" loading="lazy"></iframe>

<!-- Compatto per sidebar -->
<iframe src="https://outbreak-monitor.com/embed.html?compact=1"
  width="480" height="130" frameborder="0" loading="lazy"></iframe>

Self-contained, nessuna dipendenza esterna, mobile responsive (collassa verticale <360px). Fetcha i JSON dell'API ogni caricamento. Cache HTTP max-age=300.

Contatto

Per uso commerciale licensing custom o richieste tecniche: [email protected]