3 pontos por GN⁺ 2023-10-26 | 1 comentários | Compartilhar no WhatsApp
  • Gera especificações OpenAPI em tempo real com base nas requisições de rede da página web
  • Adiciona uma nova aba chamada 'OpenAPI' ao Chrome DevTools
    • Geração imediata de especificações OpenAPI 3.1 para sites ou aplicações
    • Mesclagem automática, por endpoint, de novos cabeçalhos de requisição e resposta, corpo e parâmetros de consulta
    • Ao clicar em parâmetros de caminho, mescla requisições correspondentes existentes e futuras
    • Permite visualizar a especificação dentro da ferramenta usando o Redocly e baixá-la com um clique
  • A extensão preenche automaticamente a especificação com base nas requisições JSON geradas durante a navegação na web
  • No menu de configurações, é possível filtrar hosts e parametrizar caminhos da URL
  • Mesmo que o mesmo endpoint responda com dados diferentes, a extensão inclui todas as informações na especificação final
  • O processo de mesclagem de requisições não pode ser desfeito, mas o usuário pode limpar a especificação e recomeçar a qualquer momento

1 comentários

 
GN⁺ 2023-10-26
Comentários no Hacker News
  • A extensão do Chrome OpenAPI DevTools é reconhecida pela sua capacidade de gerar especificações de API.
  • Os usuários a consideram útil para escrever código no console JavaScript, permitindo executar tarefas complexas rapidamente.
  • Uma das sugestões para a ferramenta é documentar cabeçalhos de autenticação e armazenar valores de token para facilitar o uso da API.
  • Foi solicitado um recurso de botão "copiar como requisição Python" para gerar snippets boilerplate em Python.
  • A ferramenta é comparada a outras semelhantes, como vite-plugin-web-extension e mitmproxy2swagger, com destaque para a grande conveniência de ser uma extensão de navegador.
  • A ferramenta recebeu elogios por sua capacidade de decifrar APIs de sites, algo que pode ser uma tarefa complicada.
  • Foram levantadas dúvidas sobre a capacidade da ferramenta de lidar com valores opcionais e marcar campos de string como "enum".
  • A ferramenta pode ser vista como um passo na direção de transformar toda a web em API, apesar das barreiras de login/cadastro.
  • Foram feitas várias sugestões de recursos, como filtragem de propriedades de resposta, trabalho com dados não JSON, referência cruzada entre APIs documentadas publicamente e nomes de host, armazenamento local de credenciais do usuário e geração de clientes com base na especificação OpenAPI.