REST : alertes et événements
S'abonner à une alerte
L'opération REST events.subscribe de Prescriptio sert à créer un abonnement de relève aux événements d'une alerte active.
POST /api/mcp/v1/events.subscribe, portée mcp:write; droits, conditions d’offre et quotas contrôlés par l’action. Même traitement que l'outil evenements_abonnement_creer.
curl -sS https://prescriptio.fr/api/mcp/v1/events.subscribe \
-H 'Authorization: Bearer <jeton>' \
-H 'Content-Type: application/json' \
-d '{"alerte_id":"00000000-0000-0000-0000-000000000001","key":"scenario-isolation"}'{
"alerte_id": "00000000-0000-0000-0000-000000000001",
"key": "scenario-isolation"
}{
"checkpoint": "<texte>",
"created": false,
"first_run": "<texte>",
"id": "<texte>",
"subscription_id": "<texte>"
}Paramètres du corps
alerte_idtexterequiskeytexterequisQuand l'utiliser
Premier démarrage : événements futurs seulement. Conserver une clé stable par automatisation.
Texte du registre des outils, rendu lisible ; la vue agent le garde tel quel.
En bref
- Adresse
POST /api/mcp/v1/events.subscribe- Contrat
- 3.0.0
- Portée OAuth
mcp:write- Conditions d’accès
- Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas.
- Outil MCP
evenements_abonnement_creer: même traitement
Erreurs et quotas
Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (marches_dce, mairies_deliberations et leurs téléchargements) qui est décomptée.
Les codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : Codes d'erreur et Authentification et quotas.
Les pages qui s'en servent
Calculé depuis la documentation : chaque page qui cite events.subscribe.