1. Ce que c'est
Batirod publie ses informations publiques sous forme de fichiers JSON statiques : identité de l'entreprise, services, zones d'intervention, questions fréquentes et nuancier de coloris. Ces fichiers sont générés à chaque déploiement du site, à partir des mêmes sources que les pages que vous lisez. L'API dit donc exactement la même chose que le site, jamais une version périmée.
Version du contrat : 1.0.0. Aucune authentification, aucun quota, en-tête Access-Control-Allow-Origin: * sur tous les documents.
2. Endpoints
- /api/index.json Index de l'API : endpoints disponibles et ressources liées.
- /api/company.json Identité, coordonnées, zone couverte, doctrine tarifaire.
- /api/services.json Services proposés et outils publics du site.
- /api/zones.json Zones d'intervention et communes disposant d'une page dédiée.
- /api/faq.json Questions fréquentes et leurs réponses officielles.
- /api/coloris.json Nuancier VEKA de référence (disponibilité selon le fabricant retenu).
Exemple, récupérer les zones d'intervention :
curl -s https://batirod.com/api/zones.json3. Spécification OpenAPI
La spec complète est publiée au format OpenAPI 3.1 : /openapi.json. Elle est aussi référencée depuis /.well-known/api-catalog, pour être trouvée sans lire cette page.
4. Serveur MCP
Batirod expose un serveur Model Context Protocol public, en lecture seule, qui donne accès aux mêmes données sous forme d'outils appelables par un assistant. La carte de découverte est publiée sur /.well-known/mcp.json.
Pour l'ajouter à un client compatible, utilisez le transport HTTP suivant :
https://batirod.com/mcp5. Ressources pour les moteurs de réponse
- /llms.txt description du site et de ses ressources pour un modèle de langage.
- /llms-full.txt contenu des pages principales en markdown, en un seul fichier.
- /.well-known/ai-answers.json faits vérifiés, citations recommandées et format d'attribution.
- Toute page du site renvoie sa version markdown si la requête porte l'en-tête
Accept: text/markdown.
6. Pas de prix, pas d'écriture
L'API ne publie aucun tarif : chaque chantier est mesuré puis chiffré dans un devis gratuit. Un agent qui produirait une estimation à partir de ces données inventerait un montant que Batirod ne tiendra pas.
Il n'existe volontairement aucun endpoint d'écriture. Une demande de devis passe par le formulaire du site, protégé contre le spam. Le serveur MCP peut préparer une demande complète et la présenter à l'utilisateur, mais c'est toujours une personne qui l'envoie.
7. Réutilisation
Ces données sont publiées sous licence CC BY 4.0. Vous pouvez les réutiliser, y compris commercialement, à condition de citer Batirod et de lier vers batirod.com.
8. Contact
Une question sur l'API, un champ manquant, un usage particulier : info@batirod.com.