Développeurs

Ressources développeurs Solo Developing

Tout le contenu de solodeveloping.com est lisible par les programmes et les agents IA : une API JSON en lecture seule, une description OpenAPI, un guide llms.txt et une version Markdown de chaque page. Aucune clé, aucun compte, aucune authentification.

API Solo Developing

Une API JSON statique en lecture seule avec le profil, les services, les produits et les articles de Fabien Chung, en français et en anglais. L’URL de base est https://solodeveloping.com/api/. Les réponses sont en JSON UTF-8 et accessibles depuis n’importe quelle origine (Access-Control-Allow-Origin: *).

GET /api/ — Index de toutes les ressources et emplacement de la description
GET /api/profile — Identité, coordonnées et services
GET /api/projects — Produits fondés et leurs composants techniques
GET /api/articles — Articles et billets courts avec leurs URL HTML et Markdown

curl https://solodeveloping.com/api/profile

Description OpenAPI

L’API est décrite par un document OpenAPI 3.1, en JSON et en YAML. Elle figure aussi dans le catalogue d’API RFC 9727, annoncé par chaque page dans un en-tête Link (rel="api-catalog").

/openapi.json — OpenAPI 3.1, JSON (aussi à /api/openapi.json)
/openapi.yaml — OpenAPI 3.1, YAML (aussi à /api/openapi.yaml)
/.well-known/api-catalog — Catalogue d’API (application/linkset+json)

Erreurs

Les erreurs sont des « problem details » RFC 9457 (application/problem+json) avec un code lisible par machine et une indication pour corriger la requête. Un chemin d’API inconnu répond 404 avec le code not_found ; toute méthode autre que GET, HEAD et OPTIONS répond 405 avec le code method_not_allowed. Partout ailleurs sur le site, une requête envoyée avec Accept: application/json reçoit aussi sa 404 en JSON.

{
  "type": "about:blank",
  "status": 404,
  "title": "Not Found",
  "code": "not_found",
  "detail": "No API resource exists at this path.",
  "hint": "List the available resources at https://solodeveloping.com/api/ …",
  "documentation": "https://solodeveloping.com/openapi.json"
}

Authentification et limites

Aucune authentification : l’API ne sert que des données publiques. Les réponses sont des fichiers statiques servis par un CDN, sans limite de débit publiée ; merci de mettre en cache ce que vous récupérez. La version actuelle est 1.0.0, indiquée dans info.version du document OpenAPI.

Pages en Markdown

Demandez n’importe quelle page avec Accept: text/markdown, ou ajoutez .md à son adresse (index.html.md pour / et /fr/), pour obtenir une version Markdown propre, sans navigation ni scripts. Les pages inconnues répondent 404 avec un corps Markdown.

curl -H 'Accept: text/markdown' https://solodeveloping.com/fr/about

Guides du site

/llms.txt — Guide pour les agents IA avec toutes les pages clés
/sitemap.xml — Toutes les URL publiques
/robots.txt — Règles des robots ; les robots IA sont autorisés

À quoi ça sert

L'API permet à des outils de répondre à des questions sur Solo Developing sans analyser le HTML. L'assistant d'un recruteur peut lire les services et les coordonnées de Fabien Chung dans /api/profile. Un agent IA qui compare des développeurs freelances à Montréal peut lister ses produits et leur stack technique dans /api/projects. Un outil de veille ou une infolettre peut récupérer les nouveaux articles dans /api/articles, avec leur date de publication et leur source Markdown.

Chaque ressource est un fichier statique : les réponses sont rapides, peuvent être mises en cache et sont identiques pour tous les clients. Rien n'est personnalisé et aucune donnée sur l'appelant n'est conservée.

Pourquoi un portfolio prêt pour les agents

De plus en plus de gens trouvent un développeur en posant la question à un assistant IA plutôt qu'à un moteur de recherche. Quand on demande à ChatGPT, Claude ou Perplexity un développeur Flutter ou full-stack à Montréal, ils lisent des pages comme celle-ci. Un Markdown propre, une API documentée et un guide llms.txt rendent cette lecture fiable : l'assistant cite des faits exacts au lieu de deviner à partir d'un bundle JavaScript.

Les mêmes briques fonctionnent pour n'importe quel site produit ou SaaS : négociation de contenu, description OpenAPI, erreurs au format problem details et catalogue d'API. Elles s'ajoutent en quelques jours et rendent un site utilisable par les agents sans intégration dédiée. Pour rendre votre site ou votre application prêts pour les agents, consultez les services de développeur IA ou écrivez-moi.

Services de développeur IA — fonctionnalités IA en production, pipelines multi-LLM et automatisation
Contact — décrivez votre projet et recevez une réponse sous 24 heures

Support

Une question sur l’API, ou une réponse qui semble erronée : écrivez à hello@solodeveloping.com.

hello@solodeveloping.com