Pile
Le probleme que je voulais resoudre
J'avais besoin d'une facon fiable de collecter, nettoyer et structurer des donnees business issues de nombreuses sources chaotiques, puis de les transmettre a d'autres outils dans une forme previsible. Mon premier reflexe, comme la plupart des gens, a ete de construire un joli dashboard. J'ai commence par les ecrans. C'est l'erreur qui m'a le plus appris.
Pourquoi je suis passe a l'API-First
En cours de route, j'ai realise que chaque consommateur de ces donnees etait un programme, pas un humain qui clique sur des boutons: une automation, un scraper, un autre agent, un futur moi qui ecrit un script a minuit. L'UI etait un mince ajout apres coup. J'ai donc tout reconstruit autour d'une API documentee, avec le dashboard comme simple client de cette API plutot que comme le produit lui-meme.
- Chaque capacite est un endpoint avec un contrat stable, pas un bouton enfoui dans un ecran.
- L'API est livree avec une spec OpenAPI, pour qu'un agent puisse la decouvrir et l'utiliser sans que j'explique quoi que ce soit.
- Les reponses sont du JSON previsible, toujours de la meme forme, pour que les consommateurs n'aient jamais a deviner.
Ce qui a change quand l'API est passee en premier
Des l'instant ou l'API est devenue le produit, tout ce qui suivait est devenu plus simple. Les automations se branchaient sans scraper d'ecrans. Les tests sont devenus triviaux, parce que je testais des endpoints, pas des parcours de clics. Et quand j'ai lance un agent IA sur la spec OpenAPI, il a su utiliser BizCollect correctement du premier coup, parce que le contrat lui disait exactement quoi envoyer et quoi recevoir. C'etait le declic: un outil qu'une IA peut comprendre et piloter sans qu'on lui tienne la main vaut bien plus en 2026 qu'un outil dans lequel seul un humain peut naviguer.
Ce que je ferais differemment
J'ecrirais la spec OpenAPI avant d'ecrire le moindre endpoint, et je la traiterais comme un document de conception. Je versionnerais aussi l'API des le premier jour, au lieu d'ajouter le versionnement plus tard. Le dashboard, on peut toujours le regenerer; un contrat d'API casse casse tous ceux qui dependent de vous, y compris des agents que vous n'avez jamais rencontres.
Leçons apprises
- Concevez l'API avant l'UI. L'API est le produit; l'UI n'est qu'un de ses clients.
- Livrez un contrat lisible par machine (OpenAPI), pour que les agents utilisent votre outil sans qu'un humain traduise la doc.
- Des reponses previsibles et identiques battent les reponses astucieuses. Les consommateurs ne devraient jamais avoir a gerer des surprises.
- Dans un monde Agent-First, "l'IA peut le piloter sans surveillance" est une vraie fonctionnalite, pas un bonus.