REST : alertes et événements
Lire les événements
L'opération REST events.poll de Prescriptio sert à lire au plus 100 événements après le point de reprise propre à l'abonnement.
POST /api/mcp/v1/events.poll, portée mcp:read; droits, conditions d’offre et quotas contrôlés par l’action. Même traitement que l'outil evenements_lire.
curl -sS https://prescriptio.fr/api/mcp/v1/events.poll \
-H 'Authorization: Bearer <jeton>' \
-H 'Content-Type: application/json' \
-d '{"subscription_id":"00000000-0000-0000-0000-000000000002"}'{
"subscription_id": "00000000-0000-0000-0000-000000000002"
}{
"checkpoint": "<texte>",
"has_more": false,
"results": [
{
"ack_token": "<texte>",
"alerte_id": "<texte>",
"entity_id": "<texte>",
"entity_type": "<texte>",
"id": "<texte>",
"occurred_at": "<texte>",
"recorded_at": "<texte>",
"subscription_id": "<texte>",
"type": "<texte>"
}
]
}Paramètres du corps
checkpointtextelimitentier100)subscription_idtexterequisQuand l'utiliser
Rejouer un point de reprise retourne les mêmes identifiants ; aucun acquittement implicite.
Texte du registre des outils, rendu lisible ; la vue agent le garde tel quel.
En bref
- Adresse
POST /api/mcp/v1/events.poll- Contrat
- 3.0.0
- Portée OAuth
mcp:read- 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_lire: 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.poll.