Je vais créer une documentation swagger api, une spécification openapi et une collection postman

Bonjour, j’écris de la documentation Swagger / OpenAPI pour des API qui n’ont jamais été correctement documentées.

Vous connaissez sans doute la situation : l’API fonctionne, mais la documentation est un simple fichier README inachevé, un vieux fichier Swagger 2.0 ou une collection Postman comprise par une seule personne. Nouveaux développeurs et clients demandent sans cesse comment fonctionne un point d’entrée.

Envoyez-moi tout ce que vous avez, même si ce ne sont que vos fichiers de routes (Express, NestJS, Next.js, FastAPI). Je vous rends :

- Une spécification Swagger / OpenAPI 3.0.3 au format YAML et JSON

- Une page de documentation HTML (Swagger UI) que vous ouvrez d’un simple double-clic, sans serveur à configurer

- Une collection Postman propre avec des dossiers, une variable baseUrl et des requêtes d’exemple

- En Premium, un SDK TypeScript typé et un serveur MCP afin que Claude ou Cursor puissent appeler votre API

Avant toute livraison, je valide la spécification par rapport au schéma officiel OpenAPI et vérifie que chaque route de votre code ou de votre documentation y figure. Si l’une manque, je la corrige d’abord.

Une remarque honnête : je documente ce qui est dans votre code et dans votre documentation. Si vous souhaitez que je le compare à votre API en live, ajoutez l’option sandbox.

Vous ne savez pas quel package vous convient ? Envoyez-moi un message, je réponds généralement dans l’heure.