/api/hazard/plane-crashes/1 créditoAcidentes aéreos
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.
https://api.occultapi.com/api/hazard/plane-crashes/Autenticação
Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.
X-API-Key: yt_live_a1b2c3d4_…Parâmetros de query (13)
Vão na URL. Todos são opcionais, a menos que estejam marcados, e podem ser combinados — primeiro filtre, depois pagine, depois ordene.
| 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`. |
Exemplo de requisição
curl "https://api.occultapi.com/api/hazard/plane-crashes/" \
-H "X-API-Key: $OCCULT_API_KEY"Resposta
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"count\": 100, \"next\": \"https://api.occultapi.com/api/hazard/plane-crashes/?page=2\", \"previous\": null, \"results\": [{\"id\": 100, \"date\": \"1926-09-29\", \"time\": \"23:55:00\", \"aircraft\": \"Farman F.60 Goliath\", \"operator\": \"French Air Force - Armée de l'Air\", \"flight_phase\": \"Flight\", \"flight_type\": \"Training\", \"crash_site\": \"Plain, Valley\", \"crash_location\": \"Bonneval Eure-et-Loir\", \"country\": \"France\", \"region\": \"Europe\", \"latitude\": 48.18118, \"longitude\": 1.386218, \"crew_fatalities\": 5, \"pax_fatalities\": 0, \"other_fatalities\": 0, \"total_fatalities\": 5, \"circumstances\": \"The crew was performing a night training flight on behalf of the 3rd Squadron of the 22nd regiment based in Chartres. While flying in the region of Bonneval, some 20 km south of Chartres, the aircraft caught fire. The pilot reduced his altitude and attempted an emergency landing. From a height of 50 meters, the aircraft stalled and crashed in a huge explosion. All five occupants were killed. Crew: Lt Jules Gindre, pilot, Sgt Pierre Pacaud, navigator, Sgt Roger Duchatelle, navigator, Sgt Raymond Rigault, mechanic, Pvt Jean Frémont, radio.\", \"crash_cause\": \"Technical failure\"}, {\"id\": 99, \"date\": \"1926-09-21\", \"time\": \"11:45:00\", \"aircraft\": \"De Havilland DH.4\", \"operator\": \"United States Army Air Corps - USAAC\", \"flight_phase\": \"Takeoff (climb)\", \"flight_type\": \"Military\", \"crash_site\": \"Airport (less than 10 km from airport)\", \"crash_location\": \"Kenley AFB Surrey\", \"country\": \"United Kingdom\", \"region\": \"Europe\", \"latitude\": 51.32609, \"longitude\": -0.101269, \"crew_fatalities\": 0, \"pax_fatalities\": 1, \"other_fatalities\": null, \"total_fatalities\": 1, \"circumstances\": \"Shortly after takeoff from RAF Kenley, while climbing, the engine failed. The aircraft stalled and crashed into trees, bursting into flames. The aircraft was destroyed and both occupants were seriously injured. The pilot died from his injuries five days later. The aircraft was based at RAF Kenley and operated on behalf of the US Embassy in London. Crew: Maj Clarence Leonard Tinker. Passenger: Cdr Robert Andrew Burg. †\", \"crash_cause\": \"Technical failure\"}, {\"id\": 98, \"date\": \"1926-09-16\", \"time\": \"20:20:00\", \"aircraft\": \"De Havilland DH.4\", \"operator\": \"Robertson Aircraft Corporation\", \"flight_phase\": \"Flight\", \"flight_type\": \"Postal (mail)\", \"crash_site\": \"Plain, Valley\", \"crash_location\": \"Ottawa Illinois\", \"country\": \"United States of America\", \"region\": \"North America\", \"latitude\": 41.346844, \"longitude\": -88.842645, \"crew_fatalities\": 0, \"pax_fatalities\": 0, \"other_fatalities\": 0, \"total_fatalities\": 0, \"circumstances\": \"The pilot Charles Lindbergh was performing a mail flight from Peoria to Chicago. En route, weather conditions worsened and he lost his orientation. Few minutes later, fuel exhausted and he eventually took the decision to bail out and abandoned the aircraft that crashed in a corn field. While the aircraft was destroyed, the aviator was unhurt.\", \"crash_cause\": \"Technical failure\"}, {\"id\": 97, \"date\": \"1926-08-20\", \"time\": \"16:05:00\", \"aircraft\": \"Hanriot HD.1\", \"operator\": \"Swiss Air Force\", \"flight_phase\": \"Flight\", \"flight_type\": \"Training\", \"crash_site\": \"Airport (less than 10 km from airport)\", \"crash_location\": \"Basel-Sternenfeld Basel City\", \"country\": \"Switzerland\", \"region\": \"Europe\", \"latitude\": 47.555943, \"longitude\": 7.588639, \"crew_fatalities\": 1, \"pax_fatalities\": 0, \"other_fatalities\": 0, \"total_fatalities\": 1, \"circumstances\": \"The pilot was performing a training flight at Basel-Sternenfeld Airport. While completing manoeuvre, he lost control of the aircraft that entered a dive and crashed near the airfield. The pilot was killed.\", \"crash_cause\": \"Human factor\"}, {\"id\": 96, \"date\": \"1926-08-18\", \"time\": \"14:30:00\", \"aircraft\": \"Blériot 155\", \"operator\": \"Air Union France\", \"flight_phase\": \"Flight\", \"flight_type\": \"Scheduled Revenue Flight\", \"crash_site\": \"Plain, Valley\", \"crash_location\": \"Ashford Kent\", \"country\": \"United Kingdom\", \"region\": \"Europe\", \"latitude\": 51.1493"
}Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.
Erros
Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.