Outils API
Choisissez une opération et un corps, puis utilisez un exemple ou le schéma.
La spécification et les corps restent dans ce navigateur ; aucune requête API n’est envoyée.
Lecture des opérations…
Les données factices OpenAPI servent à préparer les tests d’une interface avant la disponibilité de son API. Chaque jeu reste lié à une opération et à un statut précis. Cela évite de transformer à la main une réponse réussie en erreur tout en conservant des champs incompatibles.
Pour générer des données factices à partir de schémas OpenAPI, distinguez le nombre de corps du nombre d’éléments qu’ils contiennent. La quantité demandée forme un lot indépendant ; les contraintes du tableau continuent de définir chaque réponse.
Les données factices OpenAPI peuvent représenter une réponse 400 ou 404 déclarée, aussi facilement qu’une réponse 200. Choisissez l’exemple nommé du type de média concerné sans modifier la spécification. Les exemples d’un autre statut ne sont pas mélangés au résultat.
Désactivez la priorité des exemples pour échantillonner le schéma avec une graine fixe. Conservez le document, les réglages et la version du moteur pour reproduire le lot. Un exemple explicite ou une constante peut rester identique quelle que soit la graine.
L’exemple YAML initial alimente automatiquement les listes de choix. Le sens requête ne traite que requestBody ; le sens réponse utilise le statut et le média choisis. Les paramètres de chemin, de requête URL et d’en-tête restent hors de ce résultat.
Les examples nommés ou example du média passent avant ceux du schéma et de ses propriétés. Un exemple invalide provoque une erreur au lieu d’être remplacé discrètement. Désactivez la priorité pour explorer d’autres valeurs permises par les contraintes.
Un seul résultat JSON garde la forme du corps ; un lot ajoute un tableau extérieur. En JSONL, chaque ligne contient un corps complet. Ctrl/Cmd + Entrée lance la génération. Toute modification bloque l’export jusqu’au prochain résultat valide.
Retrouvez une opération par sa méthode et son chemin. La réponse peut utiliser un code précis, une plage ou default. Le choix initial privilégie 200, puis un autre 2xx, puis la première entrée. Les scénarios d’erreur disposent ainsi du même parcours que les succès.
Valeurs intégrées, exemples nommés et références locales vers un Example Object sont acceptés. Les exemples de schéma et de propriétés sont utilisés lorsqu’ils conviennent. Chaque corps est vérifié contre le schéma pris en charge pour son sens avant l’export.
Les propriétés readOnly sont exclues des requêtes, les writeOnly des réponses. Les obligations required correspondantes sont adaptées. Si un exemple fourni contient une propriété exclue, il est refusé sans suppression silencieuse de son contenu.
Préparez de 1 à 100 corps indépendants avec une graine explicite. uniqueItems impose l’unicité dans le tableau d’un corps, pas entre tous les corps du lot. Augmenter la quantité ne modifie donc pas les contraintes internes de la réponse.
Collez le document complet pris en charge, puis choisissez opération, sens et média. Gardez la priorité pour reprendre les exemples documentés, ou désactivez-la pour échantillonner le schéma. Un schéma isolé se traite avec le générateur dédié aux schémas.
Choisissez d’abord le statut et le média JSON, puis l’exemple nommé défini à cet endroit. Une valeur intégrée ou une référence locale vers un Example Object convient. Les exemples du média priment sur ceux du schéma.
Oui, si l’opération déclare cette réponse avec un schéma JSON compatible. Sélectionnez 400 ou 404 pour obtenir le corps correspondant comme jeu de test. Cela n’envoie pas de réponse HTTP et ne simule pas une panne de serveur.
La graine initiale vaut 42. Le même document et les mêmes réglages reproduisent l’échantillonnage. example, const ou un enum à une seule valeur peuvent rester fixes pour toutes les graines. Désactivez d’abord la priorité des exemples pour comparer les graines.
Non. La validation compare le corps fourni ou généré au schéma effectif pris en charge. Elle ne contacte pas l’API et n’exécute ni middleware, ni contrôle des en-têtes réels, de l’authentification ou des règles métier.
Une contrainte à ajouter ?
Commencez avec un corps de données factices OpenAPI, vérifiez son statut et sa provenance, puis augmentez la quantité si votre test exige un lot.