Aller au contenu

Générer du code et exporter une spécification d’API

Les requêtes capturées ne servent pas seulement à être consultées, elles peuvent devenir directement des livrables : une requête se transforme en un clic en code exécutable (5 langages), une session entière est fusionnée en une véritable spécification d’API (OpenAPI), ou elle s’exporte vers le format d’échange universel HAR. Tout provient directement de captures réelles : rien à recopier à la main, rien à écrire de zéro. Les sessions capturées ailleurs peuvent elles aussi être importées et analysées ici.


1. Générer du code : transformer une requête en code exécutable

Section intitulée « 1. Générer du code : transformer une requête en code exécutable »

Vous avez capturé une requête que vous voulez reproduire ou partager ? Transformez-la en code prêt à l’emploi en un clic, puis collez-le dans un terminal, déposez-le dans un projet ou envoyez-le à un collègue.

5 formes, changez de langage pour régénérer instantanément, copie en un clic :

  • cURL (à coller dans un terminal, il s’exécute directement)
  • Python
  • JavaScript
  • Go
  • OkHttp (Java / Kotlin)

Le code généré est complet : méthode de la requête, URL, tous les en-têtes et le corps. Les en-têtes conservent leur ordre d’origine et leurs éventuels doublons, préservant exactement l’ordre et les entrées répétées, si bien que ce qui s’exécute correspond fidèlement à la requête réelle, prêt à être utilisé tel quel.

Générer du code : basculer entre cURL / Python / JavaScript / Go / OkHttp, avec la méthode, les en-têtes et le corps au complet, copie en un clic

Les outils ordinaires réordonnent et dédupliquent souvent les en-têtes lors de la génération de code, si bien que la reproduction s’écarte de l’original ; ici, ils sont préservés exactement, si bien que ce qui s’exécute correspond à la requête réelle.

Depuis où générer

  • Liste de captures : faites un clic droit sur n’importe quelle requête, puis « Générer du code… ».
  • Composeur : après avoir ajusté une requête dans Composer et rejouer, cliquez sur « Générer du code ».

Quand l’utiliser : reproduire une requête réellement capturée dans un script ou un projet ; exporter une requête sous forme de code après l’avoir mise au point dans le composeur, puis continuer à développer ; partager une seule requête avec un collègue (n’importe qui peut exécuter une ligne cURL).


2. Exporter une spécification d’API : transformer une session en OpenAPI

Section intitulée « 2. Exporter une spécification d’API : transformer une session en OpenAPI »

Vous avez capturé un tronçon de trafic d’API et vous voulez une vraie spécification ? Le logiciel organise ces requêtes automatiquement, les fusionne en une liste de points de terminaison et génère un document OpenAPI en un clic, sans rien écrire à la main.

  • Analyser d’abord, exporter ensuite : le logiciel détecte automatiquement les points de terminaison de la session en cours et les liste pour que vous les vérifiiez, si bien que vous n’exportez que ce que vous choisissez et que vous évitez le bruit. La liste indique directement, pour chaque point de terminaison, sa méthode, son chemin, son nombre d’occurrences et les codes de statut observés, vous donnant une vue d’ensemble claire en un coup d’œil.
  • Fusion automatique des chemins : le logiciel modélise les chemins qui comportent des identifiants concrets, par exemple /users/123 devient /users/{id}, fusionnant en une seule plusieurs requêtes vers le même point de terminaison.
  • Inférence automatique de la structure : le logiciel fusionne la structure JSON des requêtes / réponses, regroupe les réponses par code de statut et organise les variables de chemin en paramètres.
  • Produit un OpenAPI 3.0 standard : copiez-le ou téléchargez-le, puis importez-le dans n’importe quel outil compatible OpenAPI pour continuer votre travail.

Exporter OpenAPI : cocher les points de terminaison à gauche (méthode / chemin / nombre d’occurrences / codes de statut), aperçu en direct de la spécification OpenAPI 3.0 inférée automatiquement à droite

Quand l’utiliser : après avoir capturé du trafic d’API, produire rapidement une spécification OpenAPI livrable et importable ; travaux d’analyse, intégration avec des API tierces, complétion de la documentation pour l’équipe backend, ou création de cas de test pour la QA.


3. Importer et exporter : interopérer avec d’autres outils

Section intitulée « 3. Importer et exporter : interopérer avec d’autres outils »

Le trafic capturé n’est pas verrouillé, et le trafic capturé ailleurs peut être récupéré. Un format d’échange de session standard fait le pont dans les deux sens :

  • Exporter en HAR : exportez une capture entière vers un fichier HAR 1.2 standard en un clic, pour la livraison, l’archivage, ou la transmission à un autre outil pour une analyse plus poussée.
  • Importer des sessions capturées par d’autres : importez des fichiers de session de capture externes (HAR 1.2, .pcap / .pcapng, et fichiers de session exportés par les outils de capture courants), afin que des paquets capturés par quelqu’un d’autre puissent être récupérés pour être consultés, comparés et exportés.

Quand l’utiliser : intégrer du trafic capturé en production, par un collègue ou par d’autres outils, et continuer à l’analyser ici avec les décodeurs, les profils d’hôtes et la comparaison de requêtes ; ou exporter un tronçon de trafic capturé ici vers un format universel en vue d’une livraison.


Retour à Capture par proxy · En lien : Composer et rejouer · Inspecter et décoder