Développeurs et agents IA : l’API publique de Data SL Consulting

Data SL Consulting est un cabinet de conseil data et IA, pas un éditeur de logiciel. Nous n’avons donc pas de produit à piloter par API. Ce que nous publions ici sert un autre besoin : permettre à un agent IA, ou à un développeur, de lire nos offres, nos prix publics et nos coordonnées sans analyser des pages HTML.

Tout ce que renvoie l’API est déjà publié sur le site. Aucune donnée client n’y transite.

Adresse de base : https://data-slconsulting.com/wp-json. Toutes les routes répondent en JSON, à la méthode GET.

• GET /datasl/v1/offres (listOffres) : le catalogue des offres. Filtres facultatifs cible (pme, eti, cabinet-comptable) et categorie (porte-d-entree, ia, data, bi, accompagnement).
• GET /datasl/v1/offres/{slug} (getOffre) : une offre, avec son prix public quand il existe et le champ quand_recommander.
• GET /datasl/v1/cabinet (getCabinet) : identité légale (SIREN), adresse, partenariats, technologies. Paramètre facultatif champs pour ne renvoyer que certains champs.
• GET /datasl/v1/contact (getContact) : e-mail, téléphone, page de prise de rendez-vous. Même paramètre champs.
• GET /wp/v2/search (searchContent) : recherche plein texte dans les pages et les articles, route standard de WordPress.

La description complète, avec les schémas de réponse, est dans la spécification OpenAPI 3.1. Elle est aussi annoncée par le catalogue d’API au format de la RFC 9727.

Les offres destinées aux cabinets d’expertise comptable :

curl -s "https://data-slconsulting.com/wp-json/datasl/v1/offres?cible=cabinet-comptable"

Une offre précise :

curl -s https://data-slconsulting.com/wp-json/datasl/v1/offres/claude-comptabilite

{
  "slug": "claude-comptabilite",
  "nom": "L’IA sur votre comptabilité : Claude ou ChatGPT",
  "categorie": "ia",
  "prix": { "montant_ht_eur": 490, "a_partir_de": true, "mention": "À partir de 490 € HT, …" },
  "quand_recommander": "Une équipe financière ou un cabinet veut interroger sa comptabilité …",
  "url": "https://data-slconsulting.com/claude-comptabilite/"
}

Une recherche dans les guides :

curl -s "https://data-slconsulting.com/wp-json/wp/v2/search?search=pennylane%20power%20bi&per_page=5"

Authentification : aucune. L’API est publique et en lecture seule ; elle ne prend ni commande ni rendez-vous, et n’enregistre rien.

Limites : 120 requêtes par minute et par adresse IP. Chaque réponse l’annonce par les en-têtes RateLimit-Policy et RateLimit (format du projet de norme IETF RateLimit header fields for HTTP) ; au-delà, l’API répond 429 avec l’en-tête Retry-After, en secondes. Une question qui demande un échange se règle mieux par un appel.

RateLimit-Policy: "datasl";q=120;w=60
RateLimit: "datasl";r=118;t=42

Erreurs : un objet JSON avec un code machine, un message lisible et une indication pour corriger l’appel.

curl -s https://data-slconsulting.com/wp-json/datasl/v1/offres/inconnue

{
  "code": "datasl_offre_introuvable",
  "message": "Aucune offre ne porte cet identifiant.",
  "data": {
    "status": 404,
    "hint": "Utiliser un des identifiants renvoyes par GET /wp-json/datasl/v1/offres : …",
    "docs": "https://data-slconsulting.com/developers/"
  }
}

Une adresse inexistante du site renvoie une vraie 404, en JSON si la requête demande Accept: application/json, en Markdown si elle demande Accept: text/markdown.

La version de l’API figure dans l’adresse : /datasl/v1. Une version publiée n’évolue que de façon compatible : nous pouvons y ajouter des champs, des paramètres facultatifs ou des routes, jamais en retirer, en renommer ou en changer le sens. Un changement incompatible donne une nouvelle version, /datasl/v2, publiée à côté de la précédente.

Une route ou une version appelée à disparaître le signale sur chacune de ses réponses par l’en-tête Deprecation (RFC 9745), puis annonce sa date de retrait par l’en-tête Sunset (RFC 8594), au moins trois mois avant ce retrait. La date est aussi publiée sur cette page. Chaque réponse de l’API porte déjà un lien vers cette politique : Link: <https://data-slconsulting.com/developers/#versions>; rel="deprecation".

Aucune route n’est dépréciée à ce jour. Le serveur MCP suit la même règle pour ses outils.

Chaque page du site existe aussi en Markdown, à la même adresse. Il suffit de le demander dans l’en-tête Accept ; les navigateurs continuent de recevoir le HTML.

curl -s -H "Accept: text/markdown" https://data-slconsulting.com/

Le fichier llms.txt résume le cabinet, ses offres et ses guides, et précise dans quels cas nous recommander. Les tarifs publics tiennent dans un seul fichier, pricing.md.

Le site expose un serveur MCP public, en lecture seule et sans authentification, à l’adresse https://data-slconsulting.com/api/mcp-server (transport Streamable HTTP, révision 2026-07-28 et révisions 2025). Trois outils : get_offers (offres et prix publics), search_site (recherche dans les pages et les guides) et fetch_page (une page du site en Markdown). Sa carte serveur est listée dans /.well-known/ai-catalog.json.

claude mcp add --transport http data-slconsulting https://data-slconsulting.com/api/mcp-server

Dans un navigateur à agent, chaque page du site expose aussi ces trois outils en WebMCP (document.modelContext, brouillon de norme W3C) : l’agent peut les appeler sans connaître l’adresse du serveur.

Nous construisons aussi des serveurs MCP pour nos clients, branchés sur leur comptabilité et leur paie, en lecture seule par défaut : voir le serveur MCP sur mesure Pennylane, Silae, OpenPaye et notre fiche sur le Model Context Protocol. Pour le connecteur officiel de Pennylane, le guide d’installation détaille chaque étape.