/api/hazard/suicide-attacks/1 кредитТеракты смертников
Набор данных о терактах смертников с местом и числом жертв. Это исторический реестр событий, а не астрологический расчёт; он нужен, чтобы в мунданном анализе данные о событиях и данные карт можно было брать из одного API. Записи привязаны к городу и провинции, а не к стране, а загруженные данные относятся в основном к Пакистану (Белуджистан, Хайбер-Пахтунхва, Пенджаб, Синд). Фильтруйте по `city` и `province` — в обоих поиск подстроки без учёта регистра, — по `start_date` и `end_date` относительно даты инцидента, а также по `min_killed`, `max_killed`, `min_injured` и `no_of_suicide_blasts`. `sort` принимает 'newest' (по умолчанию), 'oldest', 'killed_desc', 'killed_asc', 'injured_desc' и 'injured_asc'. Пагинация — через `page` и `itemsPerPage`: по умолчанию пятьдесят записей на странице, максимум пятьсот. Ответ имеет формат с пагинацией: `count`, `next`, `previous` и `results`. Каждый результат содержит id, дату, местное время строкой, город, провинцию, широту и долготу, текстовое поле `location` с точным местом, `killed_min` и `killed_max` (число жертв в сообщениях часто указывается диапазоном), `injured_min` и число взрывов в инциденте.
https://api.occultapi.com/api/hazard/suicide-attacks/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…Параметры строки запроса (11)
Передаются в URL. Все необязательны, если не отмечено иное, и их можно сочетать: сначала фильтр, затем страница, затем сортировка.
| Параметр | Тип | Пример | Назначение | |
|---|---|---|---|---|
| city | string | — | Фильтр по названию города (без учёта регистра, по вхождению подстроки) | |
| end_date | string | — | Фильтр по конечной дате (YYYY-MM-DD) Ограничение ФОРМАТА: 'YYYY-MM-DD'. Сравнивается с `date__lte`. | |
| itemsPerPage | integer | — | Число элементов на странице | |
| max_killed | integer | — | Фильтр по максимальному числу погибших (верхняя граница) | |
| min_injured | integer | — | Фильтр по минимальному числу раненых (нижняя граница) | |
| min_killed | integer | — | Фильтр по минимальному числу погибших (максимальное количество) | |
| no_of_suicide_blasts | integer | — | Фильтр по точному числу взрывов смертников | |
| page | integer | — | Номер страницы | |
| province | string | — | Фильтр по названию провинции (без учёта регистра, по вхождению подстроки) | |
| sort | string | — | Порядок сортировки: 'newest' (по умолчанию), 'oldest', 'killed_desc'/'killed_asc' (по числу погибших) или 'injured_desc'/'injured_asc' (по числу раненых) Без учёта регистра, пробелы по краям отбрасываются. По умолчанию 'newest'. Здесь НЕТ name_asc/name_desc, потому что name_field не передаётся. 'killed_*' сортирует по killed_max, 'injured_*' — по injured_min. Нераспознанные значения молча заменяются на 'newest'. одно из: newest, oldest, killed_desc, killed_asc, injured_desc, injured_asc | |
| start_date | string | — | Фильтр по начальной дате (YYYY-MM-DD) Ограничение ФОРМАТА: 'YYYY-MM-DD'. Сравнивается с `date__gte`. |
Пример запроса
curl "https://api.occultapi.com/api/hazard/suicide-attacks/" \
-H "X-API-Key: $OCCULT_API_KEY"Ответ
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"count\": 284, \"next\": \"https://api.occultapi.com/api/hazard/suicide-attacks/?page=2\", \"previous\": null, \"results\": [{\"id\": 284, \"date\": \"2017-11-25\", \"time\": \"7:00 AM\", \"city\": \"Quetta\", \"latitude\": 30.139626, \"longitude\": 66.981476, \"province\": \"Balochistan\", \"location\": \"Sariab Road, near Bus terminal\", \"killed_min\": 4, \"killed_max\": 4, \"injured_min\": 16, \"no_of_suicide_blasts\": 1}, {\"id\": 283, \"date\": \"2017-11-24\", \"time\": \"7:00 AM\", \"city\": \"Peshawar\", \"latitude\": 33.970623, \"longitude\": 71.43862, \"province\": \"KPK\", \"location\": \"Near Zarghuni Masjid, Phase-2 Hayatabad\", \"killed_min\": 1, \"killed_max\": 3, \"injured_min\": 6, \"no_of_suicide_blasts\": 1}, {\"id\": 282, \"date\": \"2017-11-09\", \"time\": \"7:00 AM\", \"city\": \"Quetta\", \"latitude\": 30.221057, \"longitude\": 67.002524, \"province\": \"Balochistan\", \"location\": \"Quetta's Chaman Housing Scheme on airport road\", \"killed_min\": 2, \"killed_max\": 2, \"injured_min\": 8, \"no_of_suicide_blasts\": 1}, {\"id\": 281, \"date\": \"2017-08-12\", \"time\": \"5:00 PM\", \"city\": \"Quetta\", \"latitude\": 30.203658, \"longitude\": 67.004469, \"province\": \"Balochistan\", \"location\": \"Pishin bus stop\", \"killed_min\": 15, \"killed_max\": 15, \"injured_min\": 40, \"no_of_suicide_blasts\": 1}, {\"id\": 280, \"date\": \"2017-07-24\", \"time\": \"3:55 PM\", \"city\": \"Lahore\", \"latitude\": 31.500875, \"longitude\": 74.33312, \"province\": \"Punjab\", \"location\": \"near Arfa Karim IT Tower Ferozepur Road\", \"killed_min\": 26, \"killed_max\": 27, \"injured_min\": 56, \"no_of_suicide_blasts\": 1}, {\"id\": 279, \"date\": \"2017-07-10\", \"time\": \"11:43 AM\", \"city\": \"Chaman\", \"latitude\": 30.90983, \"longitude\": 66.452402, \"province\": \"Balochistan\", \"location\": \"Boghra Road\", \"killed_min\": 1, \"killed_max\": 3, \"injured_min\": 1, \"no_of_suicide_blasts\": 1}, {\"id\": 278, \"date\": \"2017-06-23\", \"time\": \"1:30 PM\", \"city\": \"Quetta\", \"latitude\": 33.88423, \"longitude\": 70.10878, \"province\": \"Balochistan\", \"location\": \"Parachinar town in the restive tribal bel\", \"killed_min\": 30, \"killed_max\": 85, \"injured_min\": 100, \"no_of_suicide_blasts\": 3}, {\"id\": 277, \"date\": \"2017-05-12\", \"time\": \"2:30 PM\", \"city\": \"Quetta\", \"latitude\": 29.800833, \"longitude\": 66.848056, \"province\": \"Baluchistan\", \"location\": \"Town of Mastung\", \"killed_min\": 25, \"killed_max\": 28, \"injured_min\": 35, \"no_of_suicide_blasts\": 1}, {\"id\": 276, \"date\": \"2017-04-05\", \"time\": \"7:15 AM\", \"city\": \"Lahore\", \"latitude\": 31.463017, \"longitude\": 74.435675, \"province\": \"Punjab\", \"location\": \"Bedian Road\", \"killed_min\": 6, \"killed_max\": 7, \"injured_min\": 19, \"no_of_suicide_blasts\": null}, {\"id\": 275, \"date\": \"2017-02-21\", \"time\": \"9:00 AM\", \"city\": \"Tangi, Charsadda District\", \"latitude\": 34.3, \"longitude\": 71.653889, \"province\": \"KPK\", \"location\": \"Court\", \"killed_min\": 6, \"killed_max\": 7, \"injured_min\": 15, \"no_of_suicide_blasts\": 2}, {\"id\": 274, \"date\": \"2017-02-16\", \"time\": \"6:00 PM\", \"city\": \"Sehwan town\", \"latitude\": 26.419314, \"longitude\": 67.859373, \"province\": \"Sindh\", \"location\": \"Lal Shahbaz Qalandar shrine\", \"killed_min\": 70, \"killed_max\": 72, \"injured_min\": 150, \"no_of_suicide_blasts\": 1}, {\"id\": 272, \"date\": \"2017-02-15\", \"time\": \"3:30 PM\", \"city\": \"Hayatabad\", \"latitude\": 33.986111, \"longitude\": 71.456944, \"province\": \"KPK\", \"location\": \"Hayatabad Medical Complex\", \"killed_min\": 1, \"killed_max\": 1, \"injured_min\": 4, \"no_of_suicide_blasts\": 1}, {\"id\": 273, \"date\": \"2017-02-15\", \"time\": \"9:00 AM\", \"city\": \"Mosal Kor, Mohmand Agency\", \"latitude\": 34.553808, \"longitude\": 71.434141, \"province\": \"FATA\", \"location\": \"Office of political agent\", \"killed_min\": 1, \"killed_max\": 1, \"injured_min\": 0, \"no_of_suicide_blasts\": 1}, {\"id\": 271, \"date\": \"2017-02-15\", \"time\": \"8:00 AM\", \"city\": \"Ghallanai, Mohmand Agency\", \"latitude\": 34.5, \"longitude\": 71.333333, \"province\": \"FATA\", \"location\": \"main gate of Mohmand Agency headquarters, Ghallanai\", \"killed_min\": 5, \"killed_max\": 8, \"injured_min\": 0, \"no_of_suicide_blasts\": 1}, {\"id\": 270, \"date\": \"2017-02-13\", \"time\": \"6:00 PM\", \"city\": \"Lahore\", \"latitude\": 31.555382, \"longitude\": 74.3"
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.