Entre Apidog 2.8.47–2.8.50, as atualizações deste mês tornam a automação de API, a integração de repositórios e a documentação de API mais fáceis de manter — desde importações CLI modulares e criação de casos de depuração até Bitbucket Cloud, conexões GitLab auto-hospedadas e esquemas publicados a partir de subsites do Docs.
Este lançamento visa tornar a automação e a colaboração Git menos um desvio de configuração.
As atualizações do Apidog de setembro focam nos pontos onde as equipes frequentemente perdem tempo: gerenciando grandes estruturas de projeto a partir de scripts ou fluxos de trabalho de IA, importando ativos de API para o módulo correto, criando ativos de teste sem sair do terminal e conectando provedores Git existentes sem alterar a forma como as equipes já trabalham.
Em resumo:
- Automação Apidog CLI: gerencie módulos de projeto, importe dados de API multi-formato por módulo e crie casos de teste de depuração a partir de arquivos de configuração.
- Integrações de repositórios Git: adicione conexões Bitbucket Cloud e GitLab On-Prem aos fluxos de trabalho de importação/exportação de projetos.
- Usabilidade diária: tratamento de URL mais claro, melhor filtragem de relatórios de teste, preenchimento de variáveis de dados de teste e uma lista de projetos mais rápida.
- Visibilidade de Docs e desempenho: subsites do Docs publicam esquemas, e testes de desempenho relatam tempos de resposta P95 e P99.
🤖 Apidog CLI para Automação de API e Fluxos de Trabalho de IA
O Apidog CLI já se tornou um ponto de entrada útil para execuções de testes CI e automação. Este lançamento o estende para um ponto anterior no fluxo de trabalho: as equipes podem gerenciar a estrutura do projeto, trazer dados para o módulo correto e criar casos de depuração antes de executar os testes.
Gerencie módulos de projeto a partir do CLI
O Apidog CLI agora pode consultar, criar, atualizar e excluir módulos de projeto.
Isso é útil quando a estrutura do módulo precisa ser alterada como parte de um fluxo de trabalho automatizado. Após uma operação de escrita, o CLI retorna um JSON estruturado que inclui o moduleId, para que scripts e agentes possam passar o identificador para etapas posteriores de importação, teste ou manutenção, em vez de pedir a alguém para copiá-lo da interface do usuário.
Isso torna o gerenciamento de módulos parte do mesmo ciclo repetível que o teste de API e a automação de CI.
Importar dados de API para um módulo selecionado
O comando de importação CLI foi refatorado para reutilizar os recursos de análise do cliente Apidog. Você pode importar dados de API de fontes suportadas para um módulo de projeto especificado, em vez de primeiro criar os dados na interface do usuário e movê-los posteriormente.
Para migrações maiores, os resultados da importação incluem contagens de itens adicionados, atualizados, ignorados e removidos. Isso torna mais fácil para scripts, trabalhos CI e agentes de IA verificarem o que aconteceu antes de passar para a próxima etapa.
Isso é especialmente útil quando múltiplos formatos precisam ser inseridos na mesma estrutura de projeto com menos etapas de limpeza manual.
Criar casos de teste de depuração a partir da configuração
Usuários do CLI agora podem criar casos de teste de depuração de interface a partir de arquivos de configuração. Uma configuração pode definir o nome do caso, API de destino, parâmetros de requisição, corpo da requisição, autenticação, pré-processadores, pós-processadores e validação de resposta.
Após a criação, o caso de depuração pode ser aberto, editado e executado no Apidog como qualquer outro caso de depuração. Isso é útil quando a automação ou um agente prepara o ativo de teste inicial, mas um desenvolvedor ainda deseja inspecioná-lo e refiná-lo visualmente.
Juntos, o gerenciamento de módulos, importações estruturadas e a criação de casos de depuração reduzem o trabalho manual em scripts locais, pipelines CI/CD e fluxos de trabalho assistidos por IA.
Se você já tem o Apidog CLI instalado, atualize-o antes de usar as novas funcionalidades:
npm install -g apidog-cli@latestConsulte a documentação do Apidog CLI para a referência de comandos mais recente.
🔗 Integrações de Repositórios Git
Setembro também estende a importação/exportação baseada em Git para dois ambientes de repositório comuns.
Bitbucket Cloud
A importação e exportação de projetos agora suportam repositórios Bitbucket Cloud. Equipes que já usam Bitbucket Cloud podem manter seus repositórios existentes no fluxo de trabalho em vez de mover ativos de API para outra plataforma Git.
GitLab On-Prem
Organizações podem configurar uma instância GitLab On-Prem no Apidog SaaS e usá-la em fluxos de trabalho de repositório Git suportados. Cada organização gerencia sua própria conexão de forma independente, para que as equipes possam continuar usando sua configuração GitLab auto-hospedada existente.
Antes de conectar, confirme se o endereço da instância GitLab e o ambiente de rede atendem aos requisitos de conexão.
⚙️ Melhorias Diárias
O lançamento também aborda feedback frequente do trabalho diário com APIs.
URLs completas não mais conflitam com o caminho do ambiente
Ao criar ou editar uma API HTTP, inserir uma URL completa que começa com http:// ou https:// agora oculta o caminho do ambiente imediatamente. Alterar o valor de volta para um caminho relativo restaura o caminho do ambiente.
Isso remove a confusão de ver uma URL completa e um caminho de ambiente ao mesmo tempo, e elimina a necessidade de salvar primeiro para ver o comportamento.
Filtragem de relatório de teste mais útil
As listas de relatórios de teste agora suportam filtragem por *runner* e fonte de execução. Campos de exibição relacionados também foram adicionados, tornando mais fácil restringir uma longa lista de relatórios e comparar registros recentes de diferentes origens.
Variáveis de dados de teste aparecem na conclusão
As variáveis de dados de teste existentes agora aparecem tanto na conclusão de código quanto na conclusão de valor dinâmico. Ao escrever requisições ou testes, você pode pesquisar e selecionar a variável diretamente em vez de voltar para a lista de variáveis para copiar seu nome.
Listas de projetos mais rápidas
Apidog otimizou o tempo de resposta da API de lista de projetos. As listas de projetos carregam mais rapidamente ao entrar em um espaço de trabalho ou localizar um projeto, reduzindo o tempo de espera durante navegações e alternâncias frequentes.
✨ Também Neste Lançamento
Três mudanças encerram o mês, abrangendo documentação, testes de desempenho e configuração de projetos *spec-first*.
Publicar esquemas a partir de subsites do Docs
Subsites nos Docs do Apidog agora podem publicar esquemas junto com endpoints, para que os leitores de um site publicado possam vê-los no local, em vez de voltar ao site principal. Subsites empresariais podem ativar essa funcionalidade por conta própria.
Tempos de resposta P95 e P99 em testes de desempenho
Os resultados dos testes de desempenho agora relatam os tempos de resposta P95 e P99 junto com as métricas existentes. Os percentis descrevem a cauda lenta que as médias ocultam, que é geralmente a parte de uma API que os usuários realmente percebem.
Configuração de projeto no Modo Spec e importação OpenAPI
Projetos no Modo Spec agora abrem em um estado vazio mais claro, com os pontos de entrada de importação e criação OpenAPI exibidos diretamente, para que um projeto *spec-first* possa começar sem procurar o caminho.
🛠️ Correções e Melhorias Adicionais
Este ciclo também inclui as seguintes correções e pequenas alterações:
- Melhorada a forma como o status da avaliação e as ações são exibidas na janela principal e na barra de abas.
- Melhorada a forma como os convites pendentes aparecem nas listas de membros da organização e da equipe.
- Corrigido um problema onde as variáveis de Autenticação Básica no código de requisição gerado não eram expandidas e eram codificadas diretamente como Base64.
- Corrigido um problema onde a edição de uma aba não expandia campos de modelo de dados combinados referenciados usando
allOf. - Corrigido um problema onde as referências entre projetos de API a modelos de dados estavam incorretas após clonar ou copiar um projeto.
- Corrigido um problema onde os casos de depuração criados pelo CLI exibiam o tipo de autenticação como “Sem Autenticação” no cliente Web e não aplicavam a autenticação.
- Corrigido um problema onde as definições
$refde resposta OpenAPI eram silenciosamente descartadas durante a importação CLI. - Corrigido um problema onde os metadados de paginação da lista de relatórios retornavam valores incorretos de
pageSizeepageIndex. - Corrigido um problema onde a geração de relatórios de teste JUnit e HTML fazia com que o relatório JUnit contivesse apenas o resultado do último caso de teste.
- Corrigido um problema onde o menu suspenso de ambiente não abria ao alternar ambientes de URL em testes de API únicos.
- Adicionado suporte para desabilitar a entrada de recompensa por convite na página inicial através da Política Empresarial.
Para a lista completa item por item, explore o Apidog Changelog.
🌟 O Que Isso Significa
Setembro é um lançamento prático para equipes cujo trabalho abrange cada vez mais pessoas, scripts, agentes e repositórios Git.
| Foco | O que melhora | Por que é importante |
|---|---|---|
| CLI e automação | Módulos, importações e casos de depuração podem ser criados e gerenciados via CLI. | Automação e agentes podem participar mais cedo sem configuração manual da UI. |
| Colaboração Git | Bitbucket Cloud e GitLab On-Prem se conectam aos fluxos de trabalho do projeto. | As equipes podem manter os repositórios que já operam. |
| Qualidade diária | Melhorias no tratamento de URL, filtragem de relatórios, preenchimento de variáveis e carregamento de projetos. | Etapas comuns de configuração e revisão exigem menos atenção. |
| Docs, testes e specs | Esquemas são publicados com subsites do Docs, resultados de desempenho relatam P95 e P99, e o Modo Spec tem um início mais claro. | Esquemas, latência e contexto *spec-first* são visíveis sem sair do fluxo de trabalho. |
💬 Mantenha Contato
Tem feedback ou perguntas? Conecte-se com outros engenheiros de API e com a equipe Apidog:
- Junte-se à nossa comunidade no Discord para discussões e suporte em tempo real.
- Participe da nossa comunidade no Slack para conversas técnicas.
- Siga-nos no X (Twitter) e LinkedIn para as últimas atualizações.
P.S. Para cada detalhe deste lançamento, confira o Apidog Changelog.
Atenciosamente,
A Equipe Apidog