Développeurs · OpenAlert

Proposez votre source d'alerte

Votre service détecte quelque chose d'utile ? Exposez un simple fichier JSON, La Bonne Alerte s'occupe des abonnés, des emails et de la vitrine.

Le standard en 30 secondes

Votre source expose une URL publique répondant en GET avec ce JSON décrivant son état courant. Pas d'auth, pas de webhook, pas de SDK.

{
  "id": "exemple-stock-produit",
  "name": "Exemple — Retour en stock d'un produit",
  "state": "active",
  "since": "2026-07-05T09:00:00.000Z",
  "until": null,
  "message": "Le produit est de nouveau disponible à l'achat",
  "url": "https://exemple.com/produit",
  "checked_at": "2026-07-05T17:32:36.606Z"
}
Lire la spec complète OPENALERT.md →

Sources paramétrées v2

Une source peut déclarer un champ params : l'alerte est alors évaluée par abonnement (par exemple un département de vigilance). Sans params, votre manifeste reste une source broadcast classique — rien à changer.

{
  "id": "vigilance-meteo",
  "name": "Vigilance météo",
  "params": [
    {
      "key": "departement",
      "label": "Département",
      "type": "enum",
      "values": [ { "value": "05", "label": "Hautes-Alpes" } ],
      "multiple": true,
      "required": true
    }
  ]
}
Détails : « Sources paramétrées » dans OPENALERT.md →

Testez votre manifeste

Collez l'URL publique de votre alert.json. On le récupère et on le valide contre le standard OpenAlert.

Soumettre votre source

Votre manifeste est valide ? Proposez votre source pour publication sur le kiosque.

Catégories * (1 à 3)

Les sources sont examinées manuellement. Code public = badge verified possible.