DÉVELOPPEURS & ASSISTANTS
API publique et documentation développeurs
Lisez les offres, tarifs et articles du site dans un format structuré. Ces ressources publiques sont gratuites et accessibles sans compte.
Démarrer sans authentification
Cette API fournit des instantanés JSON des contenus publiés. Aucun compte, clé API, jeton ou OAuth n’est nécessaire. Elle permet uniquement de lire : elle n’envoie pas de demande de contact, ne réserve pas de prestation et ne donne accès à aucune donnée client.
Dans un terminal, définissez SITE_URL avec l’origine de ce site, sans barre finale. Lancez ensuite : curl --fail-with-body -H 'Accept: application/json' "$SITE_URL/api/v1/index.json". Dans un navigateur, ouvrez directement le lien JSON ci-dessous.
En JavaScript sur ce site : const response = await fetch('/api/v1/offers.json'); if (!response.ok) throw new Error(String(response.status)); const offers = await response.json(); console.log(offers.items);
Ressources disponibles en GET
Pages publiques
/api/v1/pages.json contient les identifiants, titres, descriptions et URL canoniques des pages indexables. Les pages noindex et les canoniques externes sont exclues.
Offres et tarifs
/api/v1/offers.json décrit les formules détaillées, leurs inclusions et conditions. Les prix de création, d’abonnement mensuel et de première année sont séparés. Un montant ambigu ou sur devis conserve son texte sans nombre inventé.
Articles publiés
/api/v1/posts.json fournit les articles du Blog et du Journal avec leur Markdown et leurs dates éditoriales réelles. Les brouillons et les articles noindex ne sont pas exposés.
Format, limites et erreurs
Les listes utilisent { version, total, items }. Chaque fichier contient la liste complète : aucun curseur, paramètre de recherche ou filtre serveur n’est pris en charge. Filtrez les éléments côté client. Les données sont régénérées lors des publications du site, pas en temps réel.
Réutilisez les réponses en cache et évitez les appels répétés inutiles. Aucun quota applicatif, en-tête de limitation ou engagement de disponibilité n’est annoncé. L’hébergement peut refuser une requête ou être temporairement indisponible.
Vérifiez le statut HTTP et le Content-Type avant de décoder le JSON. Un chemin inconnu renvoie 404 ; les erreurs de l’hébergement peuvent être HTML. Ne supposez pas que toutes les erreurs suivent un schéma JSON.
Aucun appel en écriture n’est documenté ou pris en charge par cette API. Pour une demande réelle, utilisez la page Contact ; ne transmettez pas de mots de passe ou de données sensibles.
WebMCP dans les navigateurs compatibles
Le site enregistre trois outils de lecture côté navigateur lorsque document.modelContext est disponible. Les anciennes expérimentations sur navigator.modelContext sont prises en charge en repli. Sans cette fonctionnalité expérimentale, le site et l’API restent accessibles normalement.
read_public_offers consulte les formules et conditions. search_published_posts accepte une expression query facultative et une limite limit de 1 à 20 pour retrouver des références d’articles. read_published_post lit un article public par son id exact. Les trois outils sont déclarés en lecture seule ; ils n’envoient pas de formulaire, ne commandent rien et ne lisent aucune donnée client.
Les outils lisent les mêmes fichiers JSON publics sur l’origine du site. Aucun appel n’est effectué avant l’invocation d’un outil. Cela ne constitue pas un serveur MCP distant ; la disponibilité dépend du navigateur et de l’agent utilisé.
Versionnement et découverte
Politique de dépréciation et de retrait (deprecation / sunset policy) : le contrat actuel est versionné dans /api/v1/. Les ajouts compatibles peuvent enrichir les réponses ; les clients doivent ignorer les champs inconnus. Une rupture de contrat utilisera /api/v2/. Tout retrait de v1 sera annoncé dans cette documentation avec sa date de fin avant sa date d’effet. Aucune version n’est actuellement dépréciée.
La spécification OpenAPI décrit les opérations, leurs identifiants uniques et les schémas des réponses. Le catalogue RFC 9727 et le manifeste ARD annoncent uniquement cette API de lecture publique. Aucun serveur MCP, agent autonome ou service authentifié n’est déclaré.