TELURICOTELURICO PARA DESENVOLVEDORES
Crie com contexto sísmico.
Integre relatos sísmicos com atribuição aos seus painéis, mapas e pesquisas. Uma API pública de leitura com atualização explícita e contratos previsíveis.
curl --fail-with-body 'https://www.telurico.app/api/v1/events?area=WORLD&hours=24'01 / Endpoints
Endpoints
Todos os endpoints documentados aceitam GET e OPTIONS. O acesso público do navegador usa CORS sem credenciais. As APIs privadas de contas e operadores exigem autorização própria e não integram este contrato.
| Método / caminho | Resultado |
|---|---|
GET /events | Catálogo filtrado, 25 eventos por página |
GET /events/{source}/{id} | Um evento preservado com fonte |
GET /sources | Atualização, atribuição e licenças |
GET /regions | Áreas aceitas e limites aproximados |
GET /status | Capacidades e limites do serviço |
GET /community?country=NI | Participação com limiar por país |
https://www.telurico.app/api/v1
02 / Explorador de API
Explorador de API
/api/v1/events?area=WORLD&hours=24Resposta
Aguardando uma requisição{}03 / Contrato de dados
Contrato de dados
Datas UTC usam milissegundos Unix. Magnitudes e profundidades podem ser null; não converta o desconhecido em zero. Preserve magnitude_type, review_status e profundidades negativas originais. A distância parte do centro escolhido, não estima intensidade.
Use WORLD, LATAM ou um código ISO-2 aceito. Áreas são retângulos aproximados que podem incluir regiões vizinhas ou marítimas. Para relatos próximos, envie latitude e longitude juntos; radius aceita 10–2.000 km. O centro é uma escolha de consulta, não uma medição de dispositivo.
Contatos, chats, avisos pessoais, localizações precisas dos celulares e dados brutos de movimento não são públicos. As contagens comunitárias usam limiares de privacidade e são autodeclaradas; não demonstram qualidade de detecção.
| 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 / Guia de integração
Guia de integração
Verifique state, generated_at e fetched_at. Cópias antigas são preservadas durante falhas. Uma fonte indisponível ou vazia não indica ausência de perigo. O EMSC usa o horário da consulta porque sua resposta não inclui horário de geração.
Atualize por (source, id) e preserve updated. Eventos podem ser corrigidos ou retirados. Compare uma janela completa e atual antes de remover um evento. A paginação é dinâmica: elimine duplicatas entre páginas; snapshot_at não congela os resultados.
Consulte no máximo uma vez por minuto, armazene os resultados e use espera exponencial com variação aleatória após erros de rede ou HTTP 503. Os fornecedores atualizam em intervalos distintos; consultar mais rápido não acelera os relatos.
A v1 pode adicionar campos compatíveis. Ignore campos desconhecidos. Mudanças incompatíveis exigem outra versão. Não há promessa de SLA de entrega ou desempenho de alerta.
05 / Erros e limites
Erros e limites
60 requisições por minuto por endereço de cliente. Verifique RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset (segundos). Em HTTP 429, aguarde Retry-After. Redes empresariais compartilhadas dividem o limite. Fale conosco antes de um uso de maior volume.
400 | Parâmetro inválido, desconhecido ou repetido |
|---|---|
404 | Caminho desconhecido ou evento fora do catálogo |
405 | Método HTTP não aceito |
429 | Limite de requisições; respeite Retry-After |
503 | Falha temporária; tente com espera |
{"error":"invalid_filter","request_id":"…"}
X-Request-ID · X-API-Version · RateLimit-Remaining · Retry-After
06 / Fontes e licenças
Fontes e licenças
Preserve o link, a atribuição, a licença e a indicação de campos normalizados pelo TELURICO. USGS e EMSC podem descrever o mesmo sismo; dois registros não implicam confirmação independente. Nenhum endossa o TELURICO.
Planeje uma integração conosco ↗