/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`, штат, округ, лесной круг, лесничество и участок, название пожара и координаты точки в полях `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. Подробнее — в справочнике ошибок.