/api/hazard/plane-crashes/1 кредитАвиакатастрофы
Набор данных об авиапроисшествиях с 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` с описанием произошедшего.
https://api.occultapi.com/api/hazard/plane-crashes/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…Параметры строки запроса (13)
Передаются в URL. Все необязательны, если не отмечено иное, и их можно сочетать: сначала фильтр, затем страница, затем сортировка.
| Параметр | Тип | Пример | Назначение | |
|---|---|---|---|---|
| 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`. |
Пример запроса
curl "https://api.occultapi.com/api/hazard/plane-crashes/" \
-H "X-API-Key: $OCCULT_API_KEY"Ответ
{
"_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"
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.