Intégrations et APIUrgence Élagage · API v1

← Accueil du site

Urgence Élagage s'ouvre aux logiciels des entreprises adhérentes : un logiciel de planning, de gestion d'interventions, de comptabilité ou la GMAO d'une collectivité peut lire les interventions, en créer, et être prévenu à chaque étape. Deux mécanismes, simples et standard :

• L'API : votre logiciel interroge Urgence Élagage (JSON sur HTTPS, clé d'accès).
• Les webhooks : Urgence Élagage appelle votre logiciel à chaque événement (nouvelle demande, équipe engagée, clôture…).

1. Authentification

Chaque appel porte une clé dans l'en-tête Authorization. La clé agit au nom du compte qui lui est rattaché (responsable ou régulateur) et avec les droits choisis à sa création : lecture et/ou demandes. Elle n'est affichée qu'une fois, à la création ; elle se révoque d'un clic.

GET https://urgence-elagage.fr/api/v1/interventions
Authorization: Bearer ue_live_a1b2c3d4_…

• Adresse de base : https://urgence-elagage.fr/api/v1/
• Réponses en JSON UTF-8 ; "ok": true ou "ok": false avec "error".
• Limite : 600 appels par heure et par clé (réponse 429 au-delà).
• Les dates sont des horodatages UNIX (secondes), fuseau Europe/Paris pour les libellés.

2. Routes

Statuts d'une intervention

recue → prise (équipe engagée) → depart → surplace → securise → cloturee ; ou annulee. Une demande sans urgence porte "programmee": 1 et, une fois datée, un bloc "planif".

Créer une demande

POST https://urgence-elagage.fr/api/v1/interventions
Authorization: Bearer ue_live_…
Content-Type: application/json

{
  "collectivite_id": 3,
  "demandeur_id": 12,               // facultatif : par défaut, le référent de la collectivité
  "danger": "Arbre tombé sur la voirie",
  "priorite": 1,                    // 1 danger immédiat · 2 urgent · 3 à sécuriser (facultatif)
  "adresse": "12 avenue de la Gare 46100 Capdenac-Gare",
  "lat": 44.5742, "lon": 2.0786,    // facultatif : sinon le point est placé sur la commune
  "contact": "Services techniques", "tel": "0612345678",
  "infos": "Route départementale coupée dans les deux sens",
  "programmee": 0                   // 1 = sans urgence, à planifier (aucune alarme)
}

→ { "ok": true, "id": 418, "ref": "UE-261025-7F2A" }

Pour un particulier (hors collectivité) : "particulier": 1 avec req_nom, req_tel et, facultatifs, req_email, req_adresse, req_qualite, tarifs (sms, oral ou aucun).

Exemple de fiche

{
  "id": 418, "ref": "UE-261025-7F2A", "status": "prise", "statut_label": "Prise en compte",
  "collectivite_id": 3, "collectivite": "Mairie de Capdenac-Gare",
  "danger": "Arbre tombé sur la voirie", "priorite": 1,
  "adresse": "12 avenue de la Gare 46100 Capdenac-Gare", "lat": 44.5742, "lon": 2.0786,
  "t": { "recue": 1761350400, "prise": 1761350760, "depart": null, "surplace": null, "securise": null, "cloturee": null },
  "equipe": ["Julien M.", "Thomas R."], "equipes": 1, "eta_min": 35,
  "programmee": 0, "figee": false, "montant_ht": null
}

3. Webhooks

Un webhook est une adresse HTTPS de votre logiciel. À chaque événement coché, Urgence Élagage y envoie une requête POST JSON. Votre logiciel répond 2xx ; sinon l'envoi est réessayé après 1, 5, 15 minutes, puis 1, 6 et 24 heures.

POST https://votre-logiciel.fr/urgence-elagage
Content-Type: application/json
X-UE-Event: prise
X-UE-Delivery: 2041
X-UE-Signature: sha256=3f1c…   // HMAC-SHA256 du corps, avec le secret du webhook

{ "evenement": "prise", "libelle": "Équipe engagée", "at": 1761350760, "intervention": { …fiche complète… } }

Exemple de vérification en PHP :

$corps = file_get_contents('php://input');
$attendu = 'sha256=' . hash_hmac('sha256', $corps, $secret);
if (!hash_equals($attendu, $_SERVER['HTTP_X_UE_SIGNATURE'] ?? '')) { http_response_code(401); exit; }
$evt = json_decode($corps, true);
// $evt['evenement'], $evt['intervention']['ref'], …
http_response_code(204);

4. Connecteur IA (serveur MCP)

Urgence Élagage peut être branché directement à un assistant IA comme Claude, par le protocole standard MCP. L'assistant agit alors au nom de votre compte, avec vos droits : un responsable voit toute l'entreprise, un régulateur ses interventions, une mairie uniquement les siennes. Il peut lire, chercher, résumer, préparer un bilan, et, si vous l'autorisez, créer une demande ou ajouter un message. Il ne peut jamais engager une équipe, faire avancer une intervention ni la clôturer.

Ajouter le connecteur dans Claude

1. Dans Claude (web ou application de bureau, abonnement Pro, Max, Team ou Enterprise), ouvrez Paramètres → Connecteurs puis Ajouter un connecteur personnalisé.
2. Nom : Urgence Élagage. Adresse du serveur : https://urgence-elagage.fr/mcp. Validez.
3. Cliquez sur Connecter : Urgence Élagage s'ouvre, vous vous connectez avec votre compte habituel (code SMS compris), puis vous choisissez les droits accordés et touchez Autoriser.
4. Dans une conversation, activez le connecteur et demandez par exemple : « Qui est d'astreinte ce week-end ? », « Fais-moi le bilan 2026 de Capdenac-Gare », « Où en est la demande UE-261025-7F2A ? ».

Pour un autre outil compatible MCP (Claude Code, un agent maison), le même serveur accepte aussi une clé API en en-tête Authorization: Bearer ue_live_….

5. Cas d'usage

• Planning de l'entreprise : à prise, créer un événement « Urgence UE-… » dans l'agenda de l'équipe ; à cloture, le compléter avec les heures.
• Facturation : à cloture, créer la ligne de facture à partir de cout et montant_ht (visibles pour une clé rattachée à un responsable).
• GMAO ou SIG d'une collectivité : lire chaque nuit interventions?depuis=… pour alimenter l'historique des arbres et de la voirie.
• Automatisation sans code (Zapier, Make, n8n) : un webhook par événement, puis vos scénarios.

6. Sécurité et bonnes pratiques

• Une clé par logiciel, nommée clairement ; révoquez-la dès que le logiciel n'est plus utilisé.
• Donnez le droit demandes seulement aux logiciels qui créent vraiment des demandes : chaque création alerte l'astreinte.
• Les webhooks exigent une adresse https:// publique. Vérifiez toujours la signature.
• Un assistant IA n'a que les droits du compte qui l'a autorisé, et jamais ceux d'engager ou de clôturer. Retirez l'accès si vous changez d'assistant ou d'appareil.
• Les données transmises restent celles de votre entreprise et de vos collectivités : leur usage relève de votre contrat de licence et du RGPD (vous êtes responsable de traitement).

Une question, un besoin de route supplémentaire ? Passez par le formulaire de contact du site, ou par votre responsable d'entreprise dans l'application.

Urgence Élagage · version 2.143.6 · Accueil · Guide d'utilisation · Confidentialité · Mentions légales