Загружаем песочницу
curl "https://api.occultapi.com/api/hazard/plane-crashes/" \
-H "X-API-Key: $OCCULT_API_KEY"Набор данных об авиапроисшествиях с 1920-х годов с текстовым описанием каждого случая. Это исторический реестр событий, а не астрологический расчёт; он размещён рядом с эндпоинтами карт, чтобы время и место катастрофы можно было сразу передать в расчёт карты. Фильтруйте по `country`, `region`, `aircraft`, `operator`, `crash_cause`, `flight_phase` и `flight_type` — везде поиск подстроки без учёта регистра, — по `start_date` и `end_date` относительно даты происшествия и по `min_fatalities`. `sort` принимает 'newest' (по умолчанию), 'oldest', 'name_asc' и 'name_desc' по типу воздушного судна, а также 'fatalities_desc' или 'fatalities_asc'. Пагинация — через `page` и `itemsPerPage`: по умолчанию пятьдесят записей на странице, максимум пятьсот. Ответ имеет формат с пагинацией: `count`, `next`, `previous` и `results`. Каждый результат содержит дату и местное время строкой, тип воздушного судна и оператора, фазу и тип полёта, классификацию места катастрофы и его текстовое описание, страну и регион, широту и долготу, число погибших — членов экипажа, пассажиров, прочих и всего, — указанную причину `crash_cause` и абзац `circumstances` с описанием произошедшего.
| Параметр | Тип | Пример | Назначение | |
|---|---|---|---|---|
| aircraft | string | — | Фильтр по воздушному судну (без учёта регистра, по вхождению подстроки) ПРОИЗВОЛЬНЫЙ; поиск подстроки `icontains` без учёта регистра по типу воздушного судна. | |
| country | string | — | Фильтр по стране (без учёта регистра, по вхождению подстроки) | |
| crash_cause | string | — | Фильтр по причине катастрофы (без учёта регистра, по вхождению подстроки) | |
| end_date | string | — | Фильтр по конечной дате (YYYY-MM-DD) Ограничение ФОРМАТА: 'YYYY-MM-DD'. Сравнивается с `date__lte`. | |
| flight_phase | string | — | Фильтр по фазе полёта (без учёта регистра, по вхождению подстроки) | |
| flight_type | string | — | Фильтр по типу полёта (без учёта регистра, по вхождению подстроки) | |
| itemsPerPage | integer | — | Число элементов на странице | |
| min_fatalities | integer | — | Фильтр по минимальному общему числу погибших | |
| operator | string | — | Фильтр по оператору (без учёта регистра, по вхождению подстроки) ПРОИЗВОЛЬНЫЙ; поиск подстроки `icontains` без учёта регистра по оператору/авиакомпании. | |
| page | integer | — | Номер страницы | |
| region | string | — | Фильтр по региону (без учёта регистра, по вхождению подстроки) | |
| sort | string | — | Порядок сортировки: 'newest' (по умолчанию), 'oldest', 'name_asc' (воздушное судно A-Z), 'name_desc' (Z-A), 'fatalities_desc' (сначала наибольшее число погибших) или 'fatalities_asc' (сначала наименьшее) Без учёта регистра, пробелы по краям отбрасываются. По умолчанию 'newest'. 'name_asc'/'name_desc' сортируют по ВОЗДУШНОМУ СУДНУ (name_field='aircraft', а не по имени человека. Нераспознанные значения молча заменяются на 'newest'. одно из: newest, oldest, name_asc, name_desc, fatalities_desc, fatalities_asc | |
| start_date | string | — | Фильтр по начальной дате (YYYY-MM-DD) Ограничение ФОРМАТА: 'YYYY-MM-DD'. Сравнивается с `date__gte`. |