API REST

C'est une liste fermée, pensée pour les automatisations : entreprises, marchés et dossiers de consultation, alertes et événements, e-mail et campagnes, publipostage. Chaque opération a sa fiche dans la Référence.

L'API REST et le connecteur MCP partagent le même registre, la même autorisation et les mêmes compteurs. Le connecteur sert les agents IA ; l'API sert les scénarios, les scripts et les services de votre équipe.

L'adresse et l'appel

Chaque opération répond en POST, avec un corps JSON (Content-Type: application/json), à :

https://prescriptio.fr/api/mcp/v1/{opération}

curl -X POST https://prescriptio.fr/api/mcp/v1/marches.search \
  -H "Authorization: Bearer $PRESCRIPTIO_JETON" \
  -H "Content-Type: application/json" \
  -d '{"query": "isolation", "type": "ouvert", "avec_dce": true, "sort": "deadline", "limit": 10}'

const reponse = await fetch("https://prescriptio.fr/api/mcp/v1/marches.search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PRESCRIPTIO_JETON}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "isolation", type: "ouvert", avec_dce: true, sort: "deadline", limit: 10 }),
});
const resultat = await reponse.json();

import os, requests

reponse = requests.post(
    "https://prescriptio.fr/api/mcp/v1/marches.search",
    headers={"Authorization": f"Bearer {os.environ['PRESCRIPTIO_JETON']}"},
    json={"query": "isolation", "type": "ouvert", "avec_dce": True, "sort": "deadline", "limit": 10},
)
resultat = reponse.json()

Le jeton s'obtient par OAuth 2.1 avec PKCE, comme pour le connecteur : il n'existe pas de clé d'API. Le détail est dans Authentification et quotas.

Vérifier le jeton

Une seule adresse répond en GET : /api/mcp/v1/me. Elle dit si le jeton est accepté, avec quelle offre (free, paid ou internal) et quelle portée, et ne compte dans aucun quota.

curl https://prescriptio.fr/api/mcp/v1/me \
  -H "Authorization: Bearer $PRESCRIPTIO_JETON"

{
  "authenticated": true,
  "tier": "free",
  "scope": "mcp:read",
  "api_contract_version": "3.0.0"
}

Les opérations

L'API compte 61 opérations. La liste est fermée : elle ne grandit pas d'elle-même avec les outils du connecteur. Chaque opération a sa fiche, avec son entrée, sa sortie, sa portée et un exemple : Catalogue des outils et des opérations.

Les erreurs

Le corps d'une erreur porte error.code, error.message, error.retry_after_seconds et api_contract_version :

{
  "error": {
    "code": "quota_exceeded",
    "message": "Quota par minute atteint. Reessaye dans 60s.",
    "retry_after_seconds": 60
  },
  "api_contract_version": "3.0.0"
}

Les limites

• Corps JSON de 3 Mio au plus, reçu en 30 secondes au plus ; exécution en 35 secondes au plus ; réponses marquées Cache-Control: no-store.
• Un appel qui porte un en-tête Origin, comme celui d'un navigateur, doit venir d'une origine autorisée ; sans cet en-tête, la vérification ne s'applique pas.
• Les mêmes compteurs que le connecteur : 100 appels par 24 heures et 5 par minute pour un compte gratuit, 5 000 et 30 avec l'abonnement.
• Pas d'export en masse, et aucune coordonnée d'une fiche publique.
• Les écritures exigent un compte rattaché à une organisation, avec un rôle de propriétaire, d'administrateur ou de membre.

Pour aller plus loin