Aller au contenu
Tout en local

Lister les endpoints OpenAPI

Énumère chaque endpoint d'un document OpenAPI ou Swagger sous forme de tableau lisible.

Entrée
Sortie

Lister les endpoints OpenAPI

Collez un document OpenAPI ou Swagger — JSON ou YAML, OpenAPI 3 ou Swagger 2 — et cet outil extrait chaque endpoint dans une liste lisible. Il est conçu pour le moment où vous recevez un fichier de spécification et avez besoin d'un aperçu rapide avant de plonger dans les détails : quelles routes existent, ce dont elles ont besoin et ce qu'elles retournent.

Filtrez la liste par méthode HTTP ou par tag pour vous concentrer sur une partie de l'API. Basculez les paramètres de chemin et de requête, le type de contenu du corps de la requête, les codes de réponse et si un endpoint nécessite une authentification — l'outil lit les exigences de sécurité par opération, revenant au paramètre de sécurité global du document si une opération ne le remplace pas. Activez « Ignorer les endpoints deprecated » pour masquer les routes marquées comme deprecated dans la spécification, et incluez le champ de résumé de chaque endpoint pour un contexte supplémentaire sans ouvrir le fichier source.

Triez le résultat par chemin ou par tag, et choisissez un format de sortie adapté à vos besoins suivants : une liste simple pour un coup d'œil rapide, un tableau Markdown à coller dans la documentation ou une pull request, ou CSV à ouvrir dans un tableur. Les paramètres définis avec $ref plutôt qu'inline sont ignorés plutôt que devinés, car résoudre une référence correctement nécessite le reste du document.

Tout s'exécute localement dans votre navigateur — la spécification de l'API ne quitte jamais votre appareil, ce qui importe si elle décrit un service interne ou non publié. Copiez le résultat, téléchargez-le en fichier .txt, ou envoyez-le directement dans un autre outil pour continuer.

FAQ

Supporte-t-il à la fois OpenAPI 3 et Swagger 2?
Oui. Les deux formats conservent les endpoints sous une section « paths » avec la même structure, donc le même lecteur gère l'une ou l'autre version.
Comment décide-t-il si un endpoint nécessite une authentification?
Il vérifie d'abord le champ « security » de l'opération. Un tableau vide là-bas signifie que cet endpoint désactive explicitement l'authentification; si le champ est absent, l'outil revient au paramètre « security » global du document.
Peut-il résoudre les références $ref?
Pas pour les paramètres — un paramètre défini avec $ref n'a pas de nom inline, donc il est ignoré plutôt que résolu, car cela nécessiterait de lire le reste du document.
Que se passe-t-il avec un document invalide ou non lié?
Vous verrez un message clair : un pour le texte qui n'est pas du JSON ou du YAML valide, et un autre quand le document s'analyse correctement mais n'a pas de section « paths ».
Mon spécification API est-elle téléchargée quelque part?
Non. L'analyse et le formatage se font entièrement dans votre navigateur — le document que vous collez ne quitte jamais votre appareil.