TELURICOTELURICO PARA DESARROLLADORES
Crea con contexto sísmico.
Integra reportes sísmicos con atribución en tus paneles, mapas e investigaciones. Una API pública de solo lectura con vigencia explícita y contratos predecibles.
curl --fail-with-body 'https://www.telurico.app/api/v1/events?area=WORLD&hours=24'01 / Endpoints
Endpoints
Todos los endpoints documentados aceptan GET y OPTIONS. El acceso público del navegador usa CORS sin credenciales. Las API privadas de cuentas y operadores requieren autorización independiente y quedan fuera de este contrato.
| Método / ruta | Resultado |
|---|---|
GET /events | Catálogo filtrado, 25 eventos por página |
GET /events/{source}/{id} | Un evento conservado con fuente |
GET /sources | Vigencia, atribución y licencias |
GET /regions | Áreas admitidas y límites aproximados |
GET /status | Capacidades y límites del servicio |
GET /community?country=NI | Participación con umbral por país |
https://www.telurico.app/api/v1
02 / Explorador de API
Explorador de API
/api/v1/events?area=WORLD&hours=24Respuesta
Esperando una solicitud{}03 / Contrato de datos
Contrato de datos
Las fechas UTC usan milisegundos Unix. Magnitudes y profundidades pueden ser null; no conviertas lo desconocido en cero. Conserva magnitude_type, review_status y profundidades negativas originales. La distancia parte del centro elegido, no estima intensidad.
Usa WORLD, LATAM o un código ISO-2 admitido. Las áreas son rectángulos aproximados que pueden incluir zonas vecinas o marinas. Para reportes cercanos, incluye latitude y longitude juntos; radius admite 10–2.000 km. El centro es una elección de consulta, no una medición de dispositivo.
No se publican contactos, chats, avisos personales, ubicaciones precisas de teléfonos ni trazas de movimiento. Los recuentos comunitarios tienen umbrales de privacidad y son autodeclarados; no demuestran calidad de detección.
| Campo | Significado |
|---|---|
source + id | USGS / EMSC + provider ID |
time / updated | UTC · Unix ms |
magnitude / depth_km | number | null |
review_status | reviewed | automatic | unknown |
state | current | stale | unavailable |
early_warning | false |
04 / Guía de integración
Guía de integración
Revisa state, generated_at y fetched_at. Se conservan copias antiguas ante fallas de la fuente. Una fuente no disponible o vacía no indica ausencia de peligro. EMSC usa la hora de consulta porque su respuesta no incluye hora de generación.
Actualiza por (source, id) y conserva updated. Los eventos pueden corregirse o retirarse. Compara un intervalo completo y vigente antes de eliminar un evento. La paginación es dinámica: elimina duplicados entre páginas; snapshot_at no congela los resultados.
Consulta como máximo una vez por minuto, guarda los resultados y usa espera exponencial con variación aleatoria tras errores de red o HTTP 503. Los proveedores actualizan a distintos intervalos; consultar más rápido no acelera los reportes.
La versión v1 puede añadir campos compatibles. Ignora campos desconocidos. Los cambios incompatibles requieren otra versión. No se promete SLA de entrega ni rendimiento de alerta.
05 / Errores y límites
Errores y límites
60 solicitudes por minuto por dirección de cliente. Consulta RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset (segundos). Ante HTTP 429, espera Retry-After. Las redes empresariales compartidas comparten este límite. Contáctanos antes de un uso de mayor volumen.
400 | Parámetro inválido, desconocido o repetido |
|---|---|
404 | Ruta desconocida o evento fuera del catálogo |
405 | Método HTTP no admitido |
429 | Límite de solicitudes; respeta Retry-After |
503 | Falla temporal; reintenta con espera |
{"error":"invalid_filter","request_id":"…"}
X-Request-ID · X-API-Version · RateLimit-Remaining · Retry-After
06 / Fuentes y licencias
Fuentes y licencias
Conserva enlace, atribución, licencia y la indicación de campos normalizados por TELURICO. USGS y EMSC pueden describir el mismo sismo; dos registros no implican corroboración independiente. Ninguno respalda TELURICO.
Planea tu integración con nosotros ↗