Pular para o conteúdo

Gerar Código e Exportar uma Especificação de API

As requisições capturadas não servem apenas para observar, elas podem virar entregáveis diretamente: uma requisição se transforma em código executável (5 linguagens) com um clique, uma sessão inteira é mesclada em uma especificação de API (OpenAPI) adequada, ou é exportada para o formato de intercâmbio universal HAR. Tudo vem direto de capturas reais: sem copiar à mão, sem escrever do zero. Sessões capturadas em outros lugares também podem ser importadas e analisadas aqui.


1. Gerar Código: transforme uma requisição em código executável

Seção intitulada “1. Gerar Código: transforme uma requisição em código executável”

Capturou uma requisição que você quer reproduzir ou compartilhar? Transforme-a em código pronto para executar com um clique, depois cole em um terminal, insira em um projeto ou envie a um colega.

5 formatos, troque a linguagem para regenerar na hora, copie com um clique:

  • cURL (cole em um terminal e ele executa)
  • Python
  • JavaScript
  • Go
  • OkHttp (Java / Kotlin)

O código gerado é completo: método da requisição, URL, todos os cabeçalhos e o corpo. Os cabeçalhos mantêm a ordem original e quaisquer duplicatas, preservando exatamente a ordenação e as entradas repetidas, de modo que o que executa corresponde fielmente à requisição real, pronto para usar como está.

Gerar código: alterne entre cURL / Python / JavaScript / Go / OkHttp, completo com método, cabeçalhos e corpo, cópia com um clique

As ferramentas comuns costumam reordenar e deduplicar os cabeçalhos ao gerar código, então a reprodução se distancia do original; aqui eles são preservados exatamente, de modo que o que executa corresponde à requisição real.

De onde gerar

  • Lista de captura: clique com o botão direito em qualquer requisição e escolha “Gerar código…”.
  • Compositor: depois de ajustar uma requisição em Compor e Reproduzir, clique em “Gerar código”.

Quando usar: reproduzir uma requisição real capturada em um script ou projeto; exportar uma requisição como código depois de fazê-la funcionar no compositor e continuar o desenvolvimento; compartilhar uma única requisição com um colega (qualquer um pode executar uma linha de cURL).


2. Exportar uma Especificação de API: transforme uma sessão em OpenAPI

Seção intitulada “2. Exportar uma Especificação de API: transforme uma sessão em OpenAPI”

Capturou um trecho de tráfego de API e quer uma especificação adequada? Ele organiza essas requisições automaticamente, mescla-as em uma lista de endpoints e gera um documento OpenAPI com um clique, sem escrever à mão.

  • Analise primeiro, exporte depois: ele detecta os endpoints automaticamente a partir da sessão atual e os lista para você conferir, de modo que você exporta apenas o que escolher e evita ruído. A lista mostra diretamente o método, o caminho, a contagem de ocorrências e os códigos de status observados de cada endpoint, dando um panorama claro num relance.
  • Mesclagem automática de caminhos: ele templatiza os caminhos com IDs concretos, por exemplo /users/123 vira /users/{id}, mesclando múltiplas requisições ao mesmo endpoint em uma só.
  • Inferência automática de estrutura: ele mescla a estrutura JSON das requisições / respostas, agrupa as respostas por código de status e organiza as variáveis de caminho em parâmetros.
  • Produz OpenAPI 3.0 padrão: copie ou baixe, depois importe em qualquer ferramenta compatível com OpenAPI para continuar trabalhando.

Exportar OpenAPI: confira os endpoints à esquerda (método / caminho / contagem de ocorrências / códigos de status), pré-visualização ao vivo da especificação OpenAPI 3.0 inferida automaticamente à direita

Quando usar: depois de capturar tráfego de API, produzir rapidamente uma especificação OpenAPI entregável e importável; trabalho de análise, integração com APIs de terceiros, preenchimento de documentação para a equipe de backend, ou construção de casos de teste para o QA.


3. Importar e Exportar: interoperar com outras ferramentas

Seção intitulada “3. Importar e Exportar: interoperar com outras ferramentas”

O tráfego capturado não fica preso, e o tráfego capturado em outros lugares pode ser trazido para cá. Um único formato padrão de intercâmbio de sessões faz a ponte nos dois sentidos:

  • Exportar HAR: exporte uma captura inteira para um arquivo HAR 1.2 padrão com um clique, para entrega, arquivamento ou repasse a outra ferramenta para análise adicional.
  • Importar sessões capturadas por outros: importe arquivos externos de sessão de captura (HAR 1.2, .pcap / .pcapng e arquivos de sessão exportados por ferramentas de captura comuns), de modo que os pacotes que outra pessoa capturou possam ser trazidos para visualizar, comparar e exportar.

Quando usar: trazer tráfego capturado em produção, por um colega ou por outras ferramentas, e continuar analisando aqui com os decodificadores, perfis de host e comparação de requisições; ou exportar um trecho de tráfego capturado aqui para um formato universal, para entrega.


Voltar para Captura por Proxy · Relacionados: Compor e Reproduzir · Inspecionar e Decodificar