curl "https://api.occultapi.com/api/hazard/plane-crashes/" \
-H "X-API-Key: $OCCULT_API_KEY"Um conjunto de dados armazenado de acidentes aéreos, com um relato escrito de cada um, desde a década de 1920. É um registro histórico de eventos, e não um cálculo astrológico, e está disponível junto com os endpoints de mapas para que o horário e o local de um acidente sirvam diretamente para levantar um mapa. Filtre com `country`, `region`, `aircraft`, `operator`, `crash_cause`, `flight_phase` e `flight_type`, todos com correspondência por substring, sem diferenciar maiúsculas de minúsculas, com `start_date` e `end_date` sobre a data do acidente e com `min_fatalities`. `sort` aceita 'newest' (o padrão), 'oldest', 'name_asc' e 'name_desc' pelo tipo de aeronave, e 'fatalities_desc' ou 'fatalities_asc'. A paginação usa `page` e `itemsPerPage`: cinquenta por página por padrão e até quinhentos. A resposta é um envelope paginado com `count`, `next`, `previous` e `results`. Cada resultado traz a data e uma string de hora local, o tipo de aeronave e o operador, a fase do voo e o tipo de voo, uma classificação do local do acidente e a localização em texto livre, o país e a região, latitude e longitude, as contagens de vítimas fatais da tripulação, dos passageiros, de outras pessoas e o total, a causa declarada em `crash_cause` e um parágrafo em `circumstances` descrevendo o que aconteceu.
| Parâmetro | Tipo | Exemplo | Para que serve | |
|---|---|---|---|---|
| aircraft | string | — | Filtrar por aeronave (contém; sem diferenciar maiúsculas de minúsculas) FORMATO LIVRE; correspondência por substring `icontains`, sem diferenciar maiúsculas de minúsculas, no tipo de aeronave. | |
| country | string | — | Filtrar por país (contém; sem diferenciar maiúsculas de minúsculas) | |
| crash_cause | string | — | Filtrar por causa do acidente (contém; sem diferenciar maiúsculas de minúsculas) | |
| end_date | string | — | Filtrar por data final (YYYY-MM-DD) Restrição de FORMATO: 'YYYY-MM-DD'. Comparado com `date__lte`. | |
| flight_phase | string | — | Filtrar por fase do voo (contém; sem diferenciar maiúsculas de minúsculas) | |
| flight_type | string | — | Filtrar por tipo de voo (contém; sem diferenciar maiúsculas de minúsculas) | |
| itemsPerPage | integer | — | Número de itens por página | |
| min_fatalities | integer | — | Filtrar pelo total mínimo de vítimas fatais | |
| operator | string | — | Filtrar por operador (contém; sem diferenciar maiúsculas de minúsculas) FORMATO LIVRE; correspondência por substring `icontains`, sem diferenciar maiúsculas de minúsculas, no operador/companhia aérea. | |
| page | integer | — | Número da página | |
| region | string | — | Filtrar por região (contém; sem diferenciar maiúsculas de minúsculas) | |
| sort | string | — | Ordem de classificação: 'newest' (padrão), 'oldest', 'name_asc' (aeronave, A-Z), 'name_desc' (Z-A), 'fatalities_desc' (maior número de vítimas fatais primeiro) ou 'fatalities_asc' (menor primeiro) Não diferencia maiúsculas de minúsculas; os espaços nas extremidades são removidos. Padrão: 'newest'. 'name_asc'/'name_desc' ordenam por AERONAVE (name_field='aircraft', não pelo nome de uma pessoa. Valores não reconhecidos recorrem silenciosamente a 'newest'. um destes: newest, oldest, name_asc, name_desc, fatalities_desc, fatalities_asc | |
| start_date | string | — | Filtrar por data inicial (YYYY-MM-DD) Restrição de FORMATO: 'YYYY-MM-DD'. Comparado com `date__gte`. |