/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. Детальніше — у довіднику помилок.