Public API Reference — Hantavirus
Descripción general
Hantavirus.app proporciona una API pública de solo lectura para acceso programático a los datos de brotes. La API está construida sobre tRPC y es accesible en https://api.hantavir.us.com/api/trpc.
Autenticación
La API pública es no autenticada. Todos los procedimientos de lectura están disponibles sin clave de API.
Límites de velocidad
- 60 solicitudes por minuto por dirección IP
- Encabezados de límite de velocidad incluidos en las respuestas:
X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset - Exceder los límites devuelve
429 Too Many Requests
Enrutadores tRPC
| Enrutador | Procedimientos clave | TTL de caché |
|---|---|---|
outbreak.* | getCurrent, getBySlug, list, getRiskLevel | 30s |
cases.* | getCounts, getTimeSeries | 30s |
regions.* | list, byCountry | 60s |
news.* | list, getById | Ninguno |
timeline.* | list | 60s (primera página) |
faqs.* | list | Ninguno |
advisories.* | list, byCountry | Ninguno |
ticker.* | list | 10s |
La documentación completa de los procedimientos está disponible en la referencia interna de API.
Puntos finales REST
Por comodidad, también proporcionamos envoltorios REST:
| Punto final | Método | Descripción |
|---|---|---|
/v1/outbreak/:slug | GET | Obtener encabezado del brote por slug |
/v1/outbreaks | GET | Listar todos los brotes activos |
/v1/cases/:slug | GET | Obtener recuentos de casos para un brote |
Eventos enviados por el servidor (SSE)
| Flujo | Descripción | Eventos |
|---|---|---|
/sse/ticker | Actualizaciones del ticker de noticias en vivo | text, severity, link |
/sse/ships/:mmsi | Actualizaciones de posición de buque | lat, lng, speed, heading |
Ejemplo: SSE del ticker
const source = new EventSource('https://api.hantavir.us.com/sse/ticker');
source.onmessage = (e) => {
const data = JSON.parse(e.data);
console.log(data.text, data.severity);
};Soporte de configuración regional
Todos los procedimientos sensibles a la configuración regional aceptan el idioma a través de:
- Cookie
hv-locale - Encabezado
Accept-Language - Predeterminado:
en
Compatibles: en, ar (Khaleeji del Golfo), fr
Para obtener todos los detalles de la API, consulte la documentación completa de API.