/api/hazard/forest-fires/1 créditIncendies de forêt
Un jeu de données enregistré des grands incendies de forêt détectés, organisé selon la hiérarchie administrative forestière indienne. C’est un journal d’événements historiques, et non un calcul astrologique, proposé à côté des endpoints de thème pour l’astrologie mondiale et les travaux de corrélation. Filtrez avec `state`, `district`, `circle`, `division` et `fire_name`, tous en correspondance par sous-chaîne insensible à la casse, et avec `start_date`/`end_date` sur l’heure de première détection (au format YYYY-MM-DD ou sous forme d’horodatage ISO complet). `sort` accepte 'newest' (par défaut), 'oldest', 'name_asc' ou 'name_desc' sur le nom de l’incendie. La pagination se fait avec `page` et `itemsPerPage` : cinquante résultats par page par défaut, cinq cents au maximum. La réponse est une enveloppe paginée standard composée de `count`, `next`, `previous` et `results`. Chaque résultat donne un id, les horodatages `first_detection` et `last_detection`, l’État, le district, le cercle forestier, la division et le secteur, un nom d’incendie et les coordonnées du point dans `latitude` et `longitude`. Les champs administratifs valent null pour les détections situées hors d’une division forestière cartographiée.
https://api.occultapi.com/api/hazard/forest-fires/Authentification
Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.
X-API-Key: yt_live_a1b2c3d4_…Paramètres de requête (10)
Ils se passent dans l’URL. Tous sont facultatifs sauf mention contraire, et ils se combinent : filtrage, puis pagination, puis tri.
| Paramètre | Type | Exemple | Rôle | |
|---|---|---|---|---|
| circle | string | — | Filtrer par nom de cercle (contient, insensible à la casse) | |
| district | string | — | Filtrer par nom de district (contient, insensible à la casse) | |
| division | string | — | Filtrer par nom de division (contient, insensible à la casse) | |
| end_date | string | — | Filtrer par date/heure de fin (YYYY-MM-DD ou YYYY-MM-DDTHH:MM:SS) Contrainte de FORMAT : 'YYYY-MM-DD' ou 'YYYY-MM-DDTHH:MM:SS'. Comparé avec `first_detection__lte`. | |
| fire_name | string | — | Filtrer par nom d’incendie (contient, insensible à la casse) LIBRE ; correspondance par sous-chaîne `icontains` insensible à la casse sur le nom de l’incendie. | |
| itemsPerPage | integer | — | Nombre d’éléments par page | |
| page | integer | — | Numéro de page | |
| sort | string | — | Ordre de tri : 'newest' (par défaut), 'oldest', 'name_asc' (nom de l’incendie de A à Z) ou 'name_desc' (de Z à A) Insensible à la casse et sans espaces de début et de fin. Par défaut : 'newest'. TOUTE valeur non reconnue est remplacée sans avertissement par 'newest' au lieu de provoquer une erreur. 'name_asc'/'name_desc' trient par fire_name. Les valeurs null sont toujours placées en dernier. au choix : newest, oldest, name_asc, name_desc | |
| start_date | string | — | Filtrer par date/heure de début (YYYY-MM-DD ou YYYY-MM-DDTHH:MM:SS) Contrainte de FORMAT : 'YYYY-MM-DD' ou 'YYYY-MM-DDTHH:MM:SS'. Comparé avec `first_detection__gte`. | |
| state | string | — | Filtrer par nom d’État (contient, insensible à la casse) |
Exemple de requête
curl "https://api.occultapi.com/api/hazard/forest-fires/" \
-H "X-API-Key: $OCCULT_API_KEY"Réponse
{
"_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"
}Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.
Erreurs
Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.