Documentation officielle API SignalNids JSON / GeoJSON Vie privée : coordonnées floutées

API SignalNids

Accédez aux données publiques de SignalNids (signalements confirmés, flux carte, intégrations), et proposez à vos administrés / membres un parcours simple vers la déclaration officielle.

Base : https://signalnids.fr Réponse : application/json; charset=utf-8 CTA : /signaler.php
Astuce : la recherche filtre les sections en temps réel.

Démarrage rapide

Format des réponses, URL de base et premier appel.

Format standard

Succès : 
{
  "ok": true,
  "items": [...]
}
Erreur : 
{
  "ok": false,
  "error": "API key required",
  "code": 401
}

Premier appel (public)

Endpoint recommandé :
/api/public/reports_latest.php Proxy public détecté 
curl -s "https://signalnids.fr/api/public/reports_latest.php?limit=20"
Si cet appel renvoie 401, l’accès public direct est désactivé : utilisez un proxy public côté serveur (/api/public/reports_latest.php).

Derniers signalements

Retourne les derniers signalements publics (statut “confirmé”) avec coordonnées floutées (vie privée). Réponse en JSON ou GeoJSON.

Endpoint public

Méthode : GET

URL : /api/public/reports_latest.php

Paramètres (clic)
  • limit (1..100) : nombre d’items (défaut 20)
  • page (≥1) : pagination
  • format : json ou geojson
  • city : filtre exact sur la commune
  • include_total : total (peut être désactivé en mode public)
curl -s "https://signalnids.fr/api/public/reports_latest.php?format=geojson&limit=100"

Endpoint partenaires (clé API)

Méthode : GET

URL : /api/reports_latest.php

200 OK 401 clé absente/invalide 429 rate-limit 500 indisponible 
curl -s -H "Authorization: Bearer VOTRE_CLE" \
"https://signalnids.fr/api/reports_latest.php?limit=50&format=geojson"
Important : la clé API est un secret serveur. Ne l’exposez jamais dans un code JavaScript public ni dans une URL.

Sécurité & bonnes pratiques

Recommandations pour intégrer l’API correctement (sans fuite de clé, et sans duplication inutile).

Ne pas exposer la clé

  • Ne mettez pas la clé dans une URL (?key=…) en production.
  • Ne mettez pas la clé dans du JS côté navigateur.
  • Stockez la clé dans /includes/config.secrets.php ou ENV.
Pour le grand public : utilisez un endpoint public (sans clé) ou un proxy serveur.

Limiter la “copie” SEO

  • Évitez de republier des fiches “signalement” complètes sur un autre domaine.
  • Préférez une vue carte / agrégats, et renvoyez vers SignalNids pour l’action.
  • La vie privée est protégée : coordonnées floutées (jitter) dans le flux.

Erreurs & rate-limit

Codes d’erreur et comportement recommandé côté client.

401 — Unauthorized

La clé API est absente ou invalide (mode partenaires).

{
  "ok": false,
  "error": "API key required",
  "code": 401
}

429 — Rate limit

Trop de requêtes sur une période courte. Attendez avant de retenter.

{
  "ok": false,
  "error": "Rate limit exceeded",
  "code": 429,
  "retry_after": 60
}

Intégrer “Signaler un nid”

Le meilleur parcours pour les citoyens : un bouton qui renvoie vers la déclaration officielle SignalNids.

Ajouter un bouton sur votre site

Copiez/collez ce code sur vos pages (mairie, association, rucher…).

Aller sur /signaler.php 
<a href="https://signalnids.fr/signaler.php" target="_blank" rel="noopener">
  Signaler un nid sur SignalNids
</a>