--- title: "API publique et ressources développeurs - Data SL Consulting" description: "API publique en lecture seule, spécification OpenAPI et pages en Markdown : comment agents IA et développeurs interrogent les offres et coordonnées de Data SL Consulting." url: "https://data-slconsulting.com/developers/" lang: "fr-FR" --- Data SL Consulting # Développeurs et agents IA : l’API publique de Data SL Consulting Une API en lecture seule, sa spécification OpenAPI et des pages lisibles en Markdown : ce que data-slconsulting.com met à disposition des programmes et des assistants IA. 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. API ## Les routes disponibles 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](https://data-slconsulting.com/openapi.json). Elle est aussi annoncée par le [catalogue d’API](https://data-slconsulting.com/.well-known/api-catalog) au format de la RFC 9727. Exemples ## Exemples d’appels 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" ``` Règles ## Authentification, limites et erreurs **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`. Versions ## Versions et dépréciation 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: ; rel="deprecation"`. Aucune route n’est dépréciée à ce jour. Le serveur MCP suit la même règle pour ses outils. Agents IA ## Lire le site en Markdown Chaque page du site existe aussi en Markdown. Trois façons de l’obtenir : ajouter `.md` à l’adresse ([/index.md](https://data-slconsulting.com/index.md) pour l’accueil, [/audit-ia.md](https://data-slconsulting.com/audit-ia.md) pour /audit-ia/), envoyer l’en-tête `Accept: text/markdown`, ou ajouter `?mode=agent`. Chaque page HTML annonce sa version Markdown par un lien `rel="alternate"` ; les navigateurs continuent de recevoir le HTML. ``` curl -s https://data-slconsulting.com/audit-ia.md curl -s -H "Accept: text/markdown" https://data-slconsulting.com/ ``` Le fichier [llms.txt](https://data-slconsulting.com/llms.txt) résume le cabinet, ses offres et ses guides, et précise dans quels cas nous recommander. Deux index plus courts couvrent une section chacun : [/developers/llms.txt](https://data-slconsulting.com/developers/llms.txt) (API, MCP, paquets) et [/technologies/llms.txt](https://data-slconsulting.com/technologies/llms.txt) (fiches technologiques). La [vue agent de l’accueil](https://data-slconsulting.com/?mode=agent) résume en une page les capacités, les points d’accès, l’authentification et les limites. Les tarifs publics tiennent dans un seul fichier, [pricing.md](https://data-slconsulting.com/pricing.md). Pour les outils qui découvrent un site sans aide : le catalogue de ressources pour agents [/.well-known/ard.json](https://data-slconsulting.com/.well-known/ard.json) (formats ARD et AI Catalog, entrée signée par l’identité [did:web:data-slconsulting.com](https://data-slconsulting.com/.well-known/did.json)), une compétence pour agents décrite dans [/.well-known/agent-skills/index.json](https://data-slconsulting.com/.well-known/agent-skills/index.json) (installable avec `npx skills add https://data-slconsulting.com`) et les offres en données structurées schema.org, déclarées dans [/schemamap.xml](https://data-slconsulting.com/schemamap.xml) (NLWeb). MCP ## Serveurs MCP 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](https://data-slconsulting.com/api/mcp-server/server-card) est listée dans le catalogue [/.well-known/ard.json](https://data-slconsulting.com/.well-known/ard.json), aussi servi à /.well-known/ai-catalog.json. Le serveur est inscrit au [registre MCP officiel](https://registry.modelcontextprotocol.io/v0.1/servers/com.data-slconsulting%2Fsite/versions/latest) sous le nom `com.data-slconsulting/site`. ``` claude mcp add --transport http data-slconsulting https://data-slconsulting.com/api/mcp-server ``` Dans Claude Code, le serveur et la compétence pour agents s’installent aussi ensemble, comme plugin : `/plugin marketplace add DataSL/datasl`, puis `/plugin install datasl@datasl`. 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](https://data-slconsulting.com/mcp-pennylane-silae-openpaye/) et notre [fiche sur le Model Context Protocol](https://data-slconsulting.com/mcp/). Pour le connecteur officiel de Pennylane, le [guide d’installation](https://data-slconsulting.com/pennylane-mcp-officiel-guide/) détaille chaque étape. CLI ## En ligne de commande et en JavaScript Le paquet npm officiel [datasl](https://www.npmjs.com/package/datasl) donne les mêmes informations depuis un terminal, sans clé ni installation préalable. Il sert aussi de client JavaScript (Node.js 18 ou plus, aucune dépendance). ``` npx datasl offres --cible cabinet-comptable npx datasl offre claude-comptabilite npx datasl chercher "API Pennylane" npx datasl lire /audit-ia/ npx datasl mcp ``` L’option `--json` donne une sortie exploitable par un script ou un agent. En JavaScript : `import { createClient } from 'datasl'`, puis `await createClient().offres()`. Les sources du paquet, la compétence pour agents (`npx skills add DataSL/datasl`), les manifestes de plugin et les consignes pour les agents de programmation (AGENTS.md) sont sur GitHub : [DataSL/datasl](https://github.com/DataSL/datasl). ## Une intégration à cadrer API Pennylane, entrepôt de données, assistant IA branché sur vos chiffres : nous regardons ce que vous avez déjà, puis nous vous disons par quoi commencer. [Réserver un appel](https://data-slconsulting.com/contact/) ou 01 83 64 60 25 --- Version Markdown de https://data-slconsulting.com/developers/ (pour les agents IA : en-tête Accept: text/markdown, suffixe .md ou ?mode=agent). Index du site pour les agents : https://data-slconsulting.com/llms.txt. API publique : https://data-slconsulting.com/developers/. Contact : contact@data-slconsulting.com, 01 83 64 60 25.