/api/hazard/forest-fires/1 кредитЛісові пожежі
Збережений набір даних про виявлені великі лісові пожежі, упорядкований за адміністративною структурою лісового господарства Індії. Це історичний журнал подій, а не астрологічний розрахунок; його надано для мунданної астрології та пошуку кореляцій поряд з ендпоінтами карт. Фільтруйте за `state`, `district`, `circle`, `division` і `fire_name` (усі — збіг за підрядком без урахування регістру), а також за `start_date`/`end_date` щодо часу першого виявлення (приймається як YYYY-MM-DD, так і повна мітка часу ISO). `sort` приймає 'newest' (за замовчуванням), 'oldest', 'name_asc' або 'name_desc' за назвою пожежі. Для пагінації — `page` і `itemsPerPage`: за замовчуванням п’ятдесят записів на сторінку, максимум п’ятсот. Відповідь — стандартна структура з пагінацією: `count`, `next`, `previous` і `results`. Кожен результат містить id, мітки часу `first_detection` і `last_detection`, штат, округ, лісове коло (circle), відділ і лісництво, назву пожежі та координати точки в `latitude` і `longitude`. Якщо пожежу виявлено поза лісовими відділами, нанесеними на мапу, адміністративні поля дорівнюють null.
https://api.occultapi.com/api/hazard/forest-fires/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…Параметри запиту (10)
Передаються в URL-адресі. Усі необов’язкові, якщо не позначено інше, і їх можна поєднувати: спершу фільтр, потім сторінка, потім сортування.
| Параметр | Тип | Приклад | Призначення | |
|---|---|---|---|---|
| circle | string | — | Фільтр за назвою кола (містить, без урахування регістру) | |
| district | string | — | Фільтр за назвою округу (містить, без урахування регістру) | |
| division | string | — | Фільтр за назвою відділу (містить, без урахування регістру) | |
| end_date | string | — | Фільтр за кінцевими датою й часом (YYYY-MM-DD або YYYY-MM-DDTHH:MM:SS) Обмеження ФОРМАТУ: 'YYYY-MM-DD' або 'YYYY-MM-DDTHH:MM:SS'. Порівнюється з `first_detection__lte`. | |
| fire_name | string | — | Фільтр за назвою пожежі (містить, без урахування регістру) ДОВІЛЬНИЙ; збіг за підрядком `icontains` без урахування регістру за назвою пожежі. | |
| itemsPerPage | integer | — | Кількість елементів на сторінці | |
| page | integer | — | Номер сторінки | |
| sort | string | — | Порядок сортування: 'newest' (за замовчуванням), 'oldest', 'name_asc' (назва пожежі A-Z) або 'name_desc' (Z-A) Без урахування регістру, пробіли обрізаються. За замовчуванням 'newest'. БУДЬ-ЯКЕ нерозпізнане значення не викликає помилки, а мовчки замінюється на 'newest'. 'name_asc'/'name_desc' сортують за fire_name. Значення null завжди йдуть останніми. одне з: newest, oldest, name_asc, name_desc | |
| start_date | string | — | Фільтр за початковими датою й часом (YYYY-MM-DD або YYYY-MM-DDTHH:MM:SS) Обмеження ФОРМАТУ: 'YYYY-MM-DD' або 'YYYY-MM-DDTHH:MM:SS'. Порівнюється з `first_detection__gte`. | |
| state | string | — | Фільтр за назвою штату (містить, без урахування регістру) |
Приклад запиту
curl "https://api.occultapi.com/api/hazard/forest-fires/" \
-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/forest-fires/?page=2\", \"previous\": null, \"results\": [{\"id\": 66, \"first_detection\": \"2025-06-09T13:30:00+05:30\", \"last_detection\": \"2025-06-09T13:30:00+05:30\", \"state\": \"UTTAR PRADESH\", \"district\": \"AGRA\", \"circle\": null, \"division\": null, \"range_name\": null, \"fire_name\": \"AGRA -1\", \"longitude\": 78.26051634, \"latitude\": 26.83035862}, {\"id\": 9, \"first_detection\": \"2025-04-29T01:48:00+05:30\", \"last_detection\": \"2025-04-29T01:48:00+05:30\", \"state\": \"RAJASTHAN\", \"district\": \"SIROHI\", \"circle\": \"CCF JODHPUR CIRCLE\", \"division\": \"SIROHI DIVISION\", \"range_name\": \"ABU ROAD RANGE\", \"fire_name\": \"ABU ROAD -5\", \"longitude\": 72.88706718, \"latitude\": 24.50238094}, {\"id\": 65, \"first_detection\": \"2025-04-28T02:07:00+05:30\", \"last_detection\": \"2025-04-29T01:48:00+05:30\", \"state\": \"HIMACHAL PRADESH\", \"district\": \"HAMIRPUR\", \"circle\": \"HAMIRPUR CIRCLE\", \"division\": \"HAMIRPUR DIVISION\", \"range_name\": \"AGHAR RANGE\", \"fire_name\": \"AGHAR -2\", \"longitude\": 76.54487903, \"latitude\": 31.61348206}, {\"id\": 20, \"first_detection\": \"2025-04-27T13:36:00+05:30\", \"last_detection\": \"2025-04-27T13:36:00+05:30\", \"state\": \"ANDHRA PRADESH\", \"district\": \"ALLURI SITHARAMA RAJU\", \"circle\": \"RAJAHMUNDRY CIRCLE\", \"division\": \"RAMPACHODAVARAM DIVISION\", \"range_name\": \"ADDATEEGALA RANGE\", \"fire_name\": \"ADDATEEGALA -8\", \"longitude\": 81.84477321, \"latitude\": 17.71221588}, {\"id\": 64, \"first_detection\": \"2025-04-26T13:54:00+05:30\", \"last_detection\": \"2025-04-26T13:54:00+05:30\", \"state\": \"HIMACHAL PRADESH\", \"district\": \"HAMIRPUR\", \"circle\": \"HAMIRPUR CIRCLE\", \"division\": \"HAMIRPUR DIVISION\", \"range_name\": \"AGHAR RANGE\", \"fire_name\": \"AGHAR -1\", \"longitude\": 76.56248482, \"latitude\": 31.57775419}, {\"id\": 70, \"first_detection\": \"2025-04-23T13:10:00+05:30\", \"last_detection\": \"2025-04-23T13:10:00+05:30\", \"state\": \"MADHYA PRADESH\", \"district\": \"SHEOPUR\", \"circle\": \"KUNO VAN PRANI SHEOPUR CIRCLE\", \"division\": \"KUNO PALPUR VAN PRANI SHEOPUR DIVISION\", \"range_name\": \"AGRA WEST RANGE\", \"fire_name\": \"AGRA WEST -4\", \"longitude\": 77.20371276, \"latitude\": 25.993098}, {\"id\": 100, \"first_detection\": \"2025-04-20T14:06:00+05:30\", \"last_detection\": \"2025-04-20T14:06:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"WILDLIFE WEST CIRCLE\", \"division\": \"CCF WILDLIFE PUNE DIVISION\", \"range_name\": \"REHEKURI RANGE\", \"fire_name\": \"AHMEDNAGAR -36\", \"longitude\": 75.14123428, \"latitude\": 18.52634684}, {\"id\": 99, \"first_detection\": \"2025-04-19T14:25:00+05:30\", \"last_detection\": \"2025-04-19T14:25:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"NASHIK CIRCLE\", \"division\": \"AHMEDNAGAR DIVISION\", \"range_name\": \"PARNER RANGE\", \"fire_name\": \"AHMEDNAGAR -35\", \"longitude\": 74.32290649, \"latitude\": 19.14418074}, {\"id\": 69, \"first_detection\": \"2025-04-17T02:13:00+05:30\", \"last_detection\": \"2025-04-17T02:13:00+05:30\", \"state\": \"MADHYA PRADESH\", \"district\": \"SHEOPUR\", \"circle\": \"KUNO VAN PRANI SHEOPUR CIRCLE\", \"division\": \"KUNO PALPUR VAN PRANI SHEOPUR DIVISION\", \"range_name\": \"AGRA WEST RANGE\", \"fire_name\": \"AGRA WEST -3\", \"longitude\": 77.20165544, \"latitude\": 25.95699487}, {\"id\": 98, \"first_detection\": \"2025-04-16T02:31:00+05:30\", \"last_detection\": \"2025-04-16T02:31:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"NASHIK CIRCLE\", \"division\": \"SANGAMNER DIVISION\", \"range_name\": \"RAJUR RANGE\", \"fire_name\": \"AHMEDNAGAR -34\", \"longitude\": 73.90079744, \"latitude\": 19.6026871}, {\"id\": 97, \"first_detection\": \"2025-04-16T02:31:00+05:30\", \"last_detection\": \"2025-04-16T02:31:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"NASHIK CIRCLE\", \"division\": \"AHMEDNAGAR DIVISION\", \"range_name\": \"PARNER RANGE\", \"fire_name\": \"AHMEDNAGAR -33\", \"longitude\": 74.57595382, \"latitude\": 18.97076079}, {\"id\": 96, \"first_detection\": \"2025-04-14T14:19:00+05:30\", \"last_detection\": \"2025-04-14T14:19:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"NASHIK CIRCLE\", \"division\": \"AHME"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.