Introdução

Sobre

Seja bem-vindo à documentação da versão 2.0 da API Fogo Cruzado.

Esta API fornece dados atualizados sobre tiroteios e disparos de armas de fogo nas regiões metropolitanas do Rio de Janeiro (desde julho de 2016), Recife (desde abril de 2018), Bahia (desde julho de 2022) e Pará (desde novembro de 2023).

Na versão 2.0, atualizamos os formatos de retorno para refletir as mudanças na estrutura da nossa base de dados. Essas alterações foram implementadas para representar de maneira mais precisa e eficaz a natureza dos dados coletados. A documentação a seguir oferece orientações detalhadas sobre como trabalhar com a nova estrutura. Importante: É fundamental compreender como essas mudanças podem impactar suas aplicações existentes. Recomendamos a leitura atenta desta documentação para se familiarizar com as novas estruturas de retorno da API.

Atualizações Recentes

Metadados de Última Atualização

A API agora inclui headers de metadados que informam a data e hora da última atualização dos dados de ocorrências. Esses headers facilitam o controle de cache e a sincronização de dados em aplicações cliente.

Headers disponíveis:

• X-Last-Update: Data e hora da última atualização geral das ocorrências
• X-Last-Update-State: Data e hora da última atualização específica por estado (quando aplicável)

Exemplo de resposta:

X-Last-Update: 2025-10-20T14:30:00-03:00
X-Last-Update-State: 2025-10-20T13:45:00-03:00

Fuso Horário

Todas as datas e horários retornados pela API estão agora no fuso horário de Brasília (America/São_Paulo, UTC-3).

Esta mudança garante consistência e facilita a interpretação dos dados, especialmente para análises temporais. Anteriormente, os horários eram retornados em UTC.

Importante: Se você possui aplicações que dependem do formato UTC, será necessário ajustar o tratamento de datas para considerar o offset de -03:00.

Acesso via R

Para pesquisadores e analistas que utilizam a linguagem R, disponibilizamos o pacote crossfire, desenvolvido voluntariamente por Felipe Sodré Barros. O pacote abstrai a complexidade das requisições HTTP e do tratamento dos dados retornados pela API, permitindo que você se concentre na análise e interpretação dos resultados.

Acesse o repositório: https://github.com/felipesbarros/crossfire (opens in a new tab)

Se tiver alguma dúvida ou precisar de assistência, não hesite em entrar em contato conosco. Agradecemos pelo seu interesse na API Fogo Cruzado. Esperamos que as melhorias implementadas na versão 2.0 tornem o acesso aos dados ainda mais eficiente e útil para suas pesquisas e análises.