Outils JSON pour développeurs AI · Exécution locale

Développeurs AI Espace de travail JSON

Génération en langage naturel · Schema · Zod · OpenAPI · Function Calling · MCP · 30+ outils

JSON vers OpenAPI

Quand la vraie réponse existe avant la doc, écrire components.schemas à la main est lent.

Collez le JSON de réponse, donnez un nom de modèle, cliquez « Générer OpenAPI » : un brouillon YAML.

Le brouillon n'a ni description, ni codes d'erreur, ni auth. Ajustez required et nullables selon le contrat.

Génération locale. Les données utilisateur de la réponse ne quittent pas le navigateur.

Ce n'est pas une spec paths complète

On inverse surtout le modèle depuis la réponse. Chemins, méthodes, query, codes d'erreur : à ajouter dans le dépôt de doc.

Séparer d'avec Structured Output

OpenAPI se lit et génère du code ; Structured Output contraint la sortie du modèle. Les properties peuvent être les mêmes ; les enveloppes ne se mélangent pas.

Comment faire

  1. Collez l'API Response JSON, donnez un nom de modèle, par ex. User.
  2. Cliquez « Générer OpenAPI ».
  3. Copiez le YAML, ajoutez description, example et codes d'erreur.
  4. Confrontez une deuxième réponse au Schema ; au besoin, validez d'abord.
  5. Exportez ensuite Zod ou Structured Output en gardant une seule structure cœur.

Cas d'usage

  • Compléter un modèle OpenAPI 3.1 pour une API déjà en prod.
  • Déduire un premier brouillon de doc depuis une réponse succès.
  • Envoyer un YAML au front pour s'aligner sur les champs.
  • Même nom de modèle pour la doc et la codegen.

À garder en tête

  • Sortie style 3.1, ajustable selon la version du projet.
  • Sans paths, la doc n'est pas finie.
  • Aucune réponse envoyée.

FAQ

Est-ce de l'OpenAPI 3.1 ?

La sortie est un Schema YAML style 3.1 ; ajustez selon la version du projet.

Génère-t-on des paths complets ?

Cette page part surtout de la réponse pour inférer le modèle. Chemins, méthodes, paramètres : à vous.

Quelle différence avec Structured Output ?

OpenAPI sert la doc et la codegen ; Structured Output contraint la sortie du modèle.

La réponse est-elle envoyée ?

Non.

À quoi sert le nom de modèle ?

C'est le nom dans components. Alignez-le sur votre domaine : User / Order.

Peut-on générer un corps de requête ?

Collez le JSON de requête comme entrée. Réponse succès et body : générez séparément puis assemblez à la main.

Comment apparaît nullable ?

Ne générez pas sur un seul null. Utilisez une vraie valeur, puis marquez le champ nullable à la main.

Comment l'utiliser avec Vers le code ?

La doc en OpenAPI ; les types TS / Go du dépôt via Vers le code ou un codegen open source.