Documentation API

Authentification

Toutes les requêtes authentifiées utilisent votre clé API personnelle, à passer dans l'en-tête HTTP X-API-Key.

Votre clé API est disponible dans votre tableau de bord après connexion (section "Ma clé API").

curl https://hexalert.fr/preavis -H "X-API-Key: VOTRE_CLE_API"

Sans clé API, les requêtes retournent un aperçu limité (5 résultats, champs réduits). Avec une clé API valide et un plan payant (starter ou pro), l'accès est complet.

Base URL

https://hexalert.fr

Endpoints

GET /preavis

Liste les préavis de grève, du plus récent au plus ancien.

Paramètre	Type	Description
`secteur`	string, optionnel	Filtre exact sur le secteur (ex: `Aérien`, `SNCF`, `Fonction publique`...)
`zone_geo`	string, optionnel	Filtre sur la zone géographique (correspondance exacte)

curl "https://hexalert.fr/preavis?secteur=A%C3%A9rien" \
  -H "X-API-Key: VOTRE_CLE_API"

Réponse (accès complet) :

[
  {
    "id": 42,
    "secteur": "Aérien",
    "entreprise": "easyJet France",
    "date_debut": "2026-09-13T04:59:00",
    "date_fin": "2026-09-14T23:59:00",
    "zone_geo": "France",
    "source_url": "https://...",
    "date_publication": "2026-09-04T23:25:12",
    "resume": "Préavis de grève déposé par le SNPL...",
    "statut": "confirme",
    "syndicats": [{"id": 3, "nom": "SNPL"}]
  }
]

Réponse (sans clé / plan free) : aperçu limité à 5 résultats, champs réduits.

[
  {
    "secteur": "Aérien",
    "entreprise": "easyJet France",
    "date_debut": "2026-09-13T04:59:00",
    "statut": "confirme"
  }
]

GET /preavis/{id}

Détail d'un préavis précis (accès complet, sans restriction de plan).

curl https://hexalert.fr/preavis/42

POST /alertes (authentification requise)

Crée une alerte : vous serez notifié (email ou Telegram) à chaque nouveau préavis correspondant à vos critères.

Champ	Type	Description
`secteur`	string ou null	Secteur à surveiller, ou `null` pour tous secteurs
`zone_geo`	string ou null	Zone à surveiller (recherche partielle), ou `null` pour toutes zones
`canal`	string	`"email"` ou `"telegram"`
`destination`	string	Adresse email, ou chat_id Telegram

curl -X POST https://hexalert.fr/alertes \
  -H "X-API-Key: VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{"secteur": "SNCF", "zone_geo": null, "canal": "email", "destination": "vous@exemple.fr"}'

Note : le nombre d'alertes actives simultanées dépend de votre plan (voir plus bas).

GET /alertes (authentification requise)

Liste vos propres alertes.

curl https://hexalert.fr/alertes -H "X-API-Key: VOTRE_CLE_API"

PATCH /alertes/{id} (authentification requise)

Active ou met en pause une alerte, sans la supprimer.

curl -X PATCH "https://hexalert.fr/alertes/7?actif=false" \
  -H "X-API-Key: VOTRE_CLE_API"

DELETE /alertes/{id} (authentification requise)

Supprime définitivement une alerte.

curl -X DELETE https://hexalert.fr/alertes/7 -H "X-API-Key: VOTRE_CLE_API"

Mobilité (consultation en direct, sans authentification)

Ces endpoints interrogent des flux publics en temps réel et ne stockent rien : la réponse reflète l'état au moment de l'appel.

GET /mobilite/velos

Disponibilité des vélos en libre-service, par ville.

curl "https://hexalert.fr/mobilite/velos?zone=Bordeaux"

GET /mobilite/autopartage

Disponibilité des véhicules en autopartage (Citiz, Clem, Getaround), par ville.

curl "https://hexalert.fr/mobilite/autopartage?zone=Bordeaux"

GET /mobilite/bornes-recharge

Bornes de recharge pour véhicules électriques, par ville. Données statiques uniquement (localisation, puissance, type de prise, opérateur, tarification, conditions d'accès) — pas de disponibilité en temps réel au niveau national à ce jour.

curl "https://hexalert.fr/mobilite/bornes-recharge?zone=Bordeaux"

Plans et limites

Plan	Alertes actives max	Accès API complet (/preavis)
`free`	1	Non (aperçu limité)
`starter`	10	Oui
`pro`	100	Oui

Pour changer de plan, contactez votre interlocuteur Hexalert.

Codes d'erreur

Code	Signification
`401`	Authentification requise (clé API manquante ou invalide) sur un endpoint qui l'exige
`403`	Accès refusé (ex: quota d'alertes atteint pour votre plan)
`404`	Ressource non trouvée (préavis ou alerte inexistant, ou n'appartenant pas à votre compte)

Exemples de code

Python

import requests

API_KEY = "VOTRE_CLE_API"
headers = {"X-API-Key": API_KEY}

response = requests.get("https://hexalert.fr/preavis", headers=headers, params={"secteur": "SNCF"})
preavis = response.json()

for p in preavis:
    print(p["entreprise"], "-", p["date_debut"])

JavaScript (fetch)

const API_KEY = "VOTRE_CLE_API";

fetch("https://hexalert.fr/preavis?secteur=SNCF", {
  headers: { "X-API-Key": API_KEY }
})
  .then(res => res.json())
  .then(data => console.log(data));

Documentation API — Hexalert