API frelons.apisa.fr

API REST open data — Signalements du frelon asiatique (Vespa velutina)

Base URL : https://frelons.apisa.fr
Authentification : Header X-Api-Key: VOTRE_TOKEN
Obtenez votre clé dans votre espace personnel → Mon profil → Clé API.
Formats : JSON · GeoJSON · CSV
Licence données : Open Database License (ODbL)

Carte publique

GET/api/carte Public
GeoJSON des signalements — 60 derniers jours par défaut, max 5 000 points
bboxstringZone géo : ouest,sud,est,nord ex: -1.8,47.1,0.2,48.9
deptstringDépartement ex: 14
communeintegerID commune ex: 4596
typestringobservation | nid | piege
statutstringsignale | verifie | detruit
date_mindateYYYY-MM-DD
date_maxdateYYYY-MM-DD
curl "https://frelons.apisa.fr/api/carte?dept=14&type=nid&date_min=2026-01-01"
GET/api/stats Public
Statistiques globales : nids, observations, pièges actifs, captures totales
→ { "nids_signales": 12, "nids_verifies": 4, "nids_detruits": 8,
     "observations": 47, "pieges_actifs": 5, "captures_totales": 230 }
GET/api/communes/search?q=caen Public
Recherche de communes par nom, code postal, numéro de département ou ID

Signalements

POST/api/signalements Public
Créer un signalement — limite 10/heure/IP
{
  "type": "nid",                 // observation | nid | piege
  "latitude": 49.18,
  "longitude": -0.35,
  "email": "vous@example.com",   // optionnel — reçoit une confirmation
  "commentaire": "Nid dans un chêne",
  "nombre_individus": 5,
  "niveau_urgence": "eleve",     // faible | moyen | eleve | critique
  "hauteur_nid": 6.0,
  "support_nid": "arbre"         // arbre | batiment | sol | autre
}
→ { "success": true, "uuid": "…", "lien": "https://frelons.apisa.fr/s/…" }
GET/api/signalements Authentifié
Liste des signalements avec tous les champs — mêmes filtres que /api/carte
GET/api/signalements/{uuid} Authentifié
Détail complet d'un signalement avec ses photos

Export open data

GET/api/export/csv Authentifié
Export CSV — BOM UTF-8, compatible Excel et QGIS — mêmes filtres que /api/carte
curl -H "X-Api-Key: TOKEN" \
  "https://frelons.apisa.fr/api/export/csv?dept=14&date_min=2026-01-01" \
  -o frelons_calvados_2026.csv
GET/api/export/geojson Authentifié
Export GeoJSON complet — compatible QGIS, uMap, Leaflet, GDAL
GET/api/export/stats-csv Authentifié
Statistiques agrégées par département, type et statut

Nids

GET/api/nids Authentifié
Liste des nids — filtre optionnel : ?statut=verifie
PATCH/api/nids/{uuid} Référent
Modifier le statut d'un nid dans son secteur
{ "statut": "detruit", "date_destruction": "2026-03-17",
  "methode_destruction": "entreprise agréée" }

Pièges

GET/api/pieges Authentifié
Vos pièges actifs
POST/api/pieges Authentifié
Créer un piège — limite 100 pièges par compte
{ "latitude": 49.18, "longitude": -0.35,
  "type_appat": "bière", "date_pose": "2026-03-17", "nombre_pieges": 2 }
POST/api/pieges/{id}/releves Authentifié
Ajouter un relevé de captures
{ "captures": 12, "date_releve": "2026-03-17" }

Authentification

POST/api/auth/register Public
Créer un compte — limite 5/heure/IP
{ "email": "vous@example.com", "password": "motdepasse",
  "nom": "Dupont", "prenom": "Jean" }
POST/api/auth/login Public
Connexion — retourne un token valable 1 an
{ "email": "vous@example.com", "password": "motdepasse" }
→ { "token": "abc123…", "user": { "id": 1, "role": "utilisateur" } }
GET/api/auth/me Authentifié
Profil de l'utilisateur courant

frelons.apisa.fr · Données open data ODbL · Retour à la carte