Cargando el Playground
curl "https://api.occultapi.com/api/hazard/plane-crashes/" \
-H "X-API-Key: $OCCULT_API_KEY"Un conjunto de datos almacenado de accidentes de aviación, con un relato escrito de cada uno, que se remonta a la década de 1920. Es un registro histórico de eventos y no un cálculo astrológico, y se ofrece junto a los endpoints de cartas para que la hora y el lugar de un accidente se puedan pasar directamente a una carta. Filtra con `country`, `region`, `aircraft`, `operator`, `crash_cause`, `flight_phase` y `flight_type`, todos por coincidencia parcial (subcadena) y sin distinguir mayúsculas y minúsculas, con `start_date` y `end_date` sobre la fecha del accidente, y con `min_fatalities`. `sort` admite 'newest' (por defecto), 'oldest', 'name_asc' y 'name_desc' sobre el tipo de aeronave, y 'fatalities_desc' o 'fatalities_asc'. La paginación usa `page` y `itemsPerPage`: cincuenta por página por defecto y hasta quinientos. La respuesta es una estructura paginada con `count`, `next`, `previous` y `results`. Cada resultado incluye la fecha y una cadena de hora local, el tipo de aeronave y el operador, la fase de vuelo y el tipo de vuelo, una clasificación del lugar del accidente y una ubicación en texto libre, el país y la región, la latitud y la longitud, el número de víctimas mortales de la tripulación, de los pasajeros, de otras personas y el total, la `crash_cause` indicada y un párrafo `circumstances` que describe lo ocurrido.
| Parámetro | Tipo | Ejemplo | Para qué sirve | |
|---|---|---|---|---|
| aircraft | string | — | Filtrar por aeronave (contiene, sin distinguir mayúsculas y minúsculas) FORMATO LIBRE; coincidencia de subcadena `icontains` sin distinguir mayúsculas y minúsculas sobre el tipo de aeronave. | |
| country | string | — | Filtrar por país (contiene, sin distinguir mayúsculas y minúsculas) | |
| crash_cause | string | — | Filtrar por causa del accidente (contiene, sin distinguir mayúsculas y minúsculas) | |
| end_date | string | — | Filtrar por fecha final (YYYY-MM-DD) Restricción de FORMATO: 'YYYY-MM-DD'. Se compara con `date__lte`. | |
| flight_phase | string | — | Filtrar por fase de vuelo (contiene, sin distinguir mayúsculas y minúsculas) | |
| flight_type | string | — | Filtrar por tipo de vuelo (contiene, sin distinguir mayúsculas y minúsculas) | |
| itemsPerPage | integer | — | Número de elementos por página | |
| min_fatalities | integer | — | Filtrar por número mínimo total de víctimas mortales | |
| operator | string | — | Filtrar por operador (contiene, sin distinguir mayúsculas y minúsculas) FORMATO LIBRE; coincidencia de subcadena `icontains` sin distinguir mayúsculas y minúsculas sobre el operador/aerolínea. | |
| page | integer | — | Número de página | |
| region | string | — | Filtrar por región (contiene, sin distinguir mayúsculas y minúsculas) | |
| sort | string | — | Orden: 'newest' (por defecto), 'oldest', 'name_asc' (aeronave A-Z), 'name_desc' (Z-A), 'fatalities_desc' (primero las de más víctimas mortales) o 'fatalities_asc' (primero las de menos) No distingue mayúsculas y minúsculas; sin espacios al principio ni al final. Valor por defecto: 'newest'. 'name_asc'/'name_desc' ordenan por AERONAVE (name_field='aircraft'), no por el nombre de una persona. Los valores no reconocidos vuelven sin aviso a 'newest'. uno de: newest, oldest, name_asc, name_desc, fatalities_desc, fatalities_asc | |
| start_date | string | — | Filtrar por fecha inicial (YYYY-MM-DD) Restricción de FORMATO: 'YYYY-MM-DD'. Se compara con `date__gte`. |