Como Migrar Coleções/Ambientes do Postman para Apidog

Postman, uma ferramenta de depuração de API amplamente popular, se tornou um ativo indispensável para desenvolvedores em todo o mundo. Sua interface amigável e poderosos recursos fizeram dela a escolha principal para testar e gerenciar APIs. No entanto, como qualquer ferramenta, o Postman não está sem suas limitações.

Neste post, exploraremos algumas das desvantagens que os desenvolvedores podem encontrar ao usar o Postman e discutiremos soluções potenciais para superar esses desafios. Então vamos mergulhar e descobrir os aspectos ocultos dessa ferramenta de API amplamente celebrada!

As desvantagens do Postman

• Limite de execuções: Mesmo que você compre a versão Profissional do Postman (a $39 por usuário por mês), você está limitado a executar uma coleção apenas 250 vezes por mês. Essa limitação pode ser insuficiente para equipes que usam testes automatizados extensivamente.

• Falta de colaboração: Você pode usar o Postman para gerenciar suas APIs, mas ele não tem nenhuma associação com suas coleções. Quando uma API sofre alterações, o que é comum em projetos ágeis, todos na equipe têm que reescrever manualmente todas as solicitações e testes relacionados. Isso pode se tornar extremamente desafiador e difícil de manter, especialmente para projetos maiores.
• Curva de aprendizado acentuada: Escrever scripts para pré-requisições e testes requer conhecimento técnico, o que pode ser inconveniente para muitos engenheiros de teste. Além disso, os scripts não são facilmente reutilizáveis, o que aumenta ainda mais o inconveniente.

Mudar do Postman para o Apidog

Apidog suporta quase todos os recursos principais do Postman, permitindo que você mude convenientemente do Postman para o Apidog. O método específico é o seguinte, assim como o tutorial do vídeo.

Migrar Coleções

Passo 1. Encontre as Coleções do Postman, passe o mouse sobre a coleção que você deseja exportar, clique no ícone ···, selecione "Exportar".

Passo 2. Então selecione Exportar Coleção v2.1 (recomendado) para exportar coleções. Apidog suporta a importação de dados no formato de Coleção v2.1 do Postman.

Passo 3. Clicando no "Importar" no Apidog, selecione "Postman" e faça upload de um arquivo dos downloads. No Apidog, você pode importar o arquivo JSON exportado do Postman nas configurações do projeto

Passo 4. Faça upload dos dados de saída do Postman. Clique em “Confirmar” conforme exibido abaixo.

Após a importação, as Coleções aparecerão no módulo de API do Apidog, enquanto pré-requisições/testes aparecerão sob os Endpoints de API.

Migrar Ambientes

Exportar Ambientes do Postman:

Os dados de ambiente do Postman e os dados de coleção são armazenados separadamente, então você precisará exportar o ambiente do Postman clicando nos "..." ao lado do ambiente no Postman, selecionando "Exportar" e exportando o ambiente.

Importar Ambiente do Postman para o Apidog:

Em seguida, na interface do Apidog, vá para Gerenciamento de Ambientes no canto superior direito, selecione "Importar Ambiente do Postman".

Basta selecionar o arquivo do Ambiente do Postman baixado e fazer upload para o Apidog. Isso permitirá que você importe seu ambiente do Postman para o Apidog de forma integrada.

O Apidog oferece um processo de transição suave do Postman, com compatibilidade com scripts do Postman e um recurso de importação conveniente que permite migrar seus scripts e projetos existentes sem dificuldades. Com a funcionalidade superior do Apidog e facilidade de uso, é um grande investimento para qualquer equipe de desenvolvimento de API que procura otimizar seu fluxo de trabalho.

Diferenças entre Postman e Apidog

Apidog é projetado para equipes de desenvolvimento de API, integrando design, desenvolvimento, depuração, simulação, teste e documentação de API em uma única plataforma. Ele oferece um ambiente colaborativo conveniente com uma interface visual, reduzindo significativamente a curva de aprendizado. Além disso, o Apidog é mais acessível e não tem limitações no número de execuções.

Apidog fornece compatibilidade com scripts do Postman e oferece um recurso de importação conveniente, permitindo uma transição suave do Postman para o Apidog. Você pode facilmente migrar seus scripts e projetos existentes do Postman para o Apidog sem complicações.

Durante o processo de migração, você notará algumas diferenças na filosofia de design entre Apidog e Postman. Compreender essas diferenças ajudará você a concluir a migração com sucesso.

Coleções, Casos de API e Cenários de Teste

Quando se trata de depuração de APIs no Postman, todo o processo gira em torno de solicitações. Você cria solicitações e as organiza dentro de coleções para execução. No entanto, o Apidog adota uma abordagem diferente. Você notará que ele não possui o conceito de coleções. Essa divergência decorre da lógica do Apidog, que considera todas as solicitações como específicas para uma API. Portanto, as solicitações devem ser organizadas sob suas respectivas APIs, com cada API tendo vários casos de solicitação.

Quando você faz a transição do Postman para o Apidog, a solicitação do Postman se transforma em um caso de API no Apidog. Você verá um caso de "sucesso" em cada API, onde os scripts de pré-requisição e os testes se tornam parte do caso da API. Essa reorganização no Apidog permite uma melhor gestão e estruturação das solicitações dentro do contexto mais amplo de uma API.

Quando você precisar executar uma coleção no Apidog, pode utilizar o módulo de teste automatizado. Aqui, você pode referenciar casos de API e criar um cenário de teste agrupando-os para execução. O resultado será um relatório de teste abrangente semelhante ao que você teria no Postman.

Essa abordagem oferece várias vantagens. Primeiro, um caso de API pode ser referenciado em vários cenários de teste, eliminando a necessidade de duplicar solicitações. Segundo, quaisquer alterações feitas na definição da API serão automaticamente refletidas tanto no caso de API quanto no cenário de teste correspondente. Isso resolve o desafio de colaboração que surge quando interfaces passam por modificações.

O Apidog vai um passo além ao suportar declarações condicionais e loops dentro dos Cenários de Teste. Com esse recurso, você pode organizar e configurar visualmente seus casos de API de uma maneira mais intuitiva e poderosa. Isso oferece maior flexibilidade e facilidade de uso em comparação com a abordagem baseada em coleções do Postman.

Ambientes & serviços

Muitas empresas têm múltiplos ambientes, e no Postman, alternar entre diferentes ambientes é frequentemente realizado usando variáveis de ambiente colocadas no início das URLs. No entanto, essa abordagem não é considerada elegante. Ela torna a URL da solicitação e a URL da API diferentes, e também mistura as configurações de ambiente e variáveis juntas.

No Apidog, o equivalente a uma URL de prefixo é chamado de "Serviço", que pode ser configurado dentro de cada API ou pasta de API. Cada serviço pode ter valores diferentes para diferentes ambientes, permitindo uma troca de ambiente sem costura.

Além disso, um ambiente no Apidog pode incluir vários serviços. Algumas APIs podem exigir solicitações para user.xxx.com, enquanto outras podem precisar solicitar order.xxx.com. Ao configurar um conjunto de serviços dentro de cada ambiente, você pode facilmente organizar e executar endpoints de API com suas respectivas URLs de prefixo.

Com base nessa funcionalidade, o Apidog também fornece dois ambientes especiais: o ambiente de simulação local e o ambiente de simulação na nuvem. Com esses ambientes de simulação, você não precisa mais configurar um servidor de simulação separado. Ao enviar solicitações para o ambiente de simulação designado, o servidor de simulação inteligente incorporado do Apidog responde inteligentemente com as respostas da API definidas em suas definições de API. Isso permite que os desenvolvedores front-end utilizem convenientemente o ambiente de simulação para desenvolvimento de interface mesmo antes que o desenvolvimento da API seja concluído.

Scripts & Pré/Processadores Pós

No Postman, escrever scripts é necessário tanto para pré-requisições quanto para testes, o que pode ser desafiador para alguns engenheiros de QA. No entanto, no Apidog, uma gama de pré/processadores visuais amigáveis é fornecida, facilitando o início para qualquer um.

Primeiramente, o Apidog suporta o uso direto de scripts do Postman. Você pode executá-los diretamente na seção "Script Personalizado" ou referenciá-los na seção "Scripts Públicos".

Em segundo lugar, o Apidog oferece assertivas visuais e extração de variáveis. Com a conveniência de construir expressões JsonPath, você pode facilmente recuperar qualquer elemento da resposta e realizar assertivas ou armazená-lo como uma variável, tudo isso sem escrever código.

Em terceiro lugar, o Apidog suporta operações em banco de dados. Você pode consultar um banco de dados em pré-processadores para buscar valores como parâmetros de solicitação ou realizar assertivas consultando o banco de dados em pós-processadores. Bancos de dados populares como MySQL, Oracle, SQL Server, PostgreSQL e ClickHouse são suportados para operações de leitura e gravação.