Créer une alerte | Documentation Prescriptio

POST /api/mcp/v1/alertes.create, portée mcp:write; droits, conditions d’offre et quotas contrôlés par l’action. Même traitement que l'outil evenements_alertes.

Attention :

Notifications ultérieures de l’alerte

Créer l’alerte n’envoie pas d’e-mail pendant l’appel. Cela ne garantit pas son exclusion des récapitulatifs ultérieurs : le traitement relit les préférences de notification du compte et du type d’événement. L’absence de contrôle du canal de l’alerte sur ce chemin est déduite du code local, non vérifiée par un essai d’envoi. Vérifiez Paramètres › Notifications ; ce réglage concerne le compte, pas seulement cette alerte.

exemple synthétique

curl -sS https://prescriptio.fr/api/mcp/v1/alertes.create \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"departement":"69","frequency":"daily","name":"Veille synthétique isolation","query":"isolation","sources":["marche"]}'

{
  "departement": "69",
  "frequency": "daily",
  "name": "Veille synthétique isolation",
  "query": "isolation",
  "sources": [
    "marche"
  ]
}

Réponsegénérée depuis le schéma

{
  "action": null,
  "alerte": {
    "created_at": "<texte>",
    "departements": [
      "<texte>"
    ],
    "evaluee": "<texte>",
    "frequency": "<texte>",
    "id": "<texte>",
    "is_active": false,
    "kind": "<texte>",
    "montant_min": 0,
    "name": "<texte>",
    "query": "<texte>",
    "sources": [
      "<texte>"
    ],
    "sources_surveillees": [
      "<texte>"
    ]
  },
  "created": false,
  "unchanged": false,
  "warnings": [
    "<texte>"
  ]
}

Paramètres du corps

departementtexte

Code département (01-95, 2A, 2B, 971-978). Filtre aussi les attributions sur leur département renseigné ; un contrat sans département reste hors d’une alerte départementale. Sur la source dce, restreint aux dossiers rapprochés d’un marché.

departementsliste

Plusieurs codes département (mêmes regles que département) : une région = la liste de ses départements.

frequencytexte

Espacement minimal du rejeu (défaut daily). Le robot passe toutes les 3 heures : realtime = a chaque passage, daily = au plus une fois par jour, weekly = une fois par semaine. (valeurs : realtime · daily · weekly)

montant_minnombre

Montant minimum en euros. S'applique a la source attribution uniquement (DECP, montant renseigne). Sans effet sur marché, dce et permis : le montant estimé n'est publié que sur 0,12 % des avis ouverts, le filtre y viderait l'alerte. (min 0)

nametexterequis

Nom de l'alerte (requis pour add). Reutiliser un nom existant avec d'autres criteres est une erreur : supprimer puis recreer. (max. 120 caractères)

querytexterequis

Mots-cles rejoues (requis pour add, 2 caracteres minimum). Une liste separee par des virgules vaut un ou. (max. 500 caractères)

sourcesliste

Sources surveillables, défaut = toutes. Marché = nouveaux avis publiés, plus un rappel quand la remise approche (J-7) ; dce = nouveaux dossiers de consultation citant vos termes ; attribution = marchés attribués (DECP) citant vos termes, dans les départements suivis ; permis = permis autorisés des 45 derniers jours (Sitadel, publié par dumps) ; reseaux_sociaux = nouveaux posts observés sur les réseaux sociaux citant vos termes ; mairie = nouveaux PV de conseils municipaux citant vos termes ; bodacc = nouvelles annonces légales (BODACC) citant vos termes ; entreprise = nouvelles entreprises de l'annuaire citant vos termes ; contact = nouveaux contacts de l'annuaire citant vos termes ; dvf = ventes immobilières récentes des départements suivis (le terme n'y est pas appliqué) ; site = nouvelles pages de sites d'entreprises citant vos termes. Aucune autre source n'est surveillable : une valeur hors de cette liste est refusee.

Quand l'utiliser

Même nom et mêmes critères : rejeu sans duplication ; critères différents : conflit. Le cron évalue périodiquement, sans garantie de temps réel amont.

Texte du registre des outils, rendu lisible ; la vue agent le garde tel quel.

En bref

Adresse: POST /api/mcp/v1/alertes.create
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_alertes : 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 alertes.create.

AlertesDocumentation, Les modules Événements et relèveIA, Intégrations API RESTIA, Intégrations Événements d'alerteRéférence, Pour commencer

Voir aussi

Référence APIL'adresse, l'authentification et les codes de réponse evenements_alertesLa même action par le connecteur MCP OpenAPILe schéma machine de toutes les opérations

curl -sS https://prescriptio.fr/api/mcp/v1/alertes.create \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"departement":"69","frequency":"daily","name":"Veille synthétique isolation","query":"isolation","sources":["marche"]}'

{ "action": null, "alerte": { "created_at": "<texte>", "departements": [ "<texte>" ], "evaluee": "<texte>", "frequency": "<texte>", "id": "<texte>", "is_active": false, "kind": "<texte>", "montant_min": 0, "name": "<texte>", "query": "<texte>", "sources": [ "<texte>" ], "sources_surveillees": [ "<texte>" ] }, "created": false, "unchanged": false, "warnings": [ "<texte>" ] }

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Créer une alerte L'opération REST alertes.create de Prescriptio sert à créer une alerte autorisée. > **Attention :** Créer l’alerte n’envoie pas d’e-mail pendant l’appel. Cela ne garantit pas son exclusion des récapitulatifs ultérieurs : le traitement relit les préférences de notification du compte et du type d’événement. L’absence de contrôle du canal de l’alerte sur ce chemin est déduite du code local, non vérifiée par un essai d’envoi. Vérifiez **Paramètres › Notifications** ; ce réglage concerne le compte, pas seulement cette alerte. ### Exemple d'appel, synthétique **curl** ```bash curl -sS https://prescriptio.fr/api/mcp/v1/alertes.create \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"departement":"69","frequency":"daily","name":"Veille synthétique isolation","query":"isolation","sources":["marche"]}' ``` **Corps JSON** ```json { "departement": "69", "frequency": "daily", "name": "Veille synthétique isolation", "query": "isolation", "sources": [ "marche" ] } ``` ### Forme de la réponse, générée depuis le schéma ```json { "action": null, "alerte": { "created_at": "<texte>", "departements": [ "<texte>" ], "evaluee": "<texte>", "frequency": "<texte>", "id": "<texte>", "is_active": false, "kind": "<texte>", "montant_min": 0, "name": "<texte>", "query": "<texte>", "sources": [ "<texte>" ], "sources_surveillees": [ "<texte>" ] }, "created": false, "unchanged": false, "warnings": [ "<texte>" ] } ``` ## Paramètres du corps | Nom | Type | Requis | Description | |---|---|---|---| | `departement` | texte | — | Code département (01-95, 2A, 2B, 971-978). Filtre aussi les attributions sur leur département renseigné ; un contrat sans département reste hors d’une alerte départementale. Sur la source dce, restreint aux dossiers rapprochés d’un marché. | | `departements` | liste | — | Plusieurs codes département (mêmes regles que département) : une région = la liste de ses départements. | | `frequency` | texte | — | Espacement MINIMAL du rejeu (défaut daily). Le robot passe toutes les 3 heures : realtime = a chaque passage, daily = au plus une fois par jour, weekly = une fois par semaine. (valeurs : `realtime` · `daily` · `weekly`) | | `montant_min` | nombre | — | Montant minimum en euros. S'applique a la source attribution UNIQUEMENT (DECP, montant renseigne). Sans effet sur marché, dce et permis : le montant estimé n'est publié que sur 0,12 % des avis ouverts, le filtre y viderait l'alerte. (min 0) | | `name` | texte | oui | Nom de l'alerte (requis pour add). Reutiliser un nom existant avec d'AUTRES criteres est une erreur : supprimer puis recreer. (max. 120 caractères) | | `query` | texte | oui | Mots-cles rejoues (requis pour add, 2 caracteres minimum). Une liste separee par des virgules vaut un OU. (max. 500 caractères) | | `sources` | liste | — | Sources surveillables, défaut = toutes. marché = nouveaux avis publiés, plus un rappel quand la remise approche (J-7) ; dce = nouveaux dossiers de consultation citant vos termes ; attribution = marchés attribués (DECP) citant vos termes, dans les départements suivis ; permis = permis autorisés des 45 derniers jours (Sitadel, publié par dumps) ; reseaux_sociaux = nouveaux posts observés sur les réseaux sociaux citant vos termes ; mairie = nouveaux PV de conseils municipaux citant vos termes ; bodacc = nouvelles annonces légales (BODACC) citant vos termes ; entreprise = nouvelles entreprises de l'annuaire citant vos termes ; contact = nouveaux contacts de l'annuaire citant vos termes ; dvf = ventes immobilières récentes des départements suivis (le terme n'y est pas appliqué) ; site = nouvelles pages de sites d'entreprises citant vos termes. Aucune autre source n'est surveillable : une valeur hors de cette liste est REFUSEE. | ## Quand l'utiliser Même nom et mêmes critères : rejeu sans duplication ; critères différents : conflit. Le cron évalue périodiquement, sans garantie de temps réel amont. ## En bref | | | |---|---| | Adresse | `POST /api/mcp/v1/alertes.create` | | 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_alertes`](https://prescriptio.fr/docs/api/evenements_alertes) : 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](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas). ## Les pages qui s'en servent Calculé depuis la documentation : chaque page qui cite `alertes.create`. - [Alertes](https://prescriptio.fr/docs/alertes) : Documentation, Les modules - [Événements et relève](https://prescriptio.fr/docs/integrations/evenements) : IA, Intégrations - [API REST](https://prescriptio.fr/docs/integrations/api-rest) : IA, Intégrations - [Événements d'alerte](https://prescriptio.fr/docs/reference/evenements) : Référence, Pour commencer ## Voir aussi - [Référence API](https://prescriptio.fr/docs/reference) : L'adresse, l'authentification et les codes de réponse - [evenements_alertes](https://prescriptio.fr/docs/api/evenements_alertes) : La même action par le connecteur MCP - [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations