Ao desenvolver APIs, a depuração é sempre um problema chato.
Postman pode ajudar a enviar requisições, mas quando o corpo da API é complicado, construir um corpo JSON seria difícil. Junit também funciona, mas todas as requisições devem ser construídas manualmente nas classes de teste.
Corpos complexos fazem com que muitos backends abandonem os testes unitários e entreguem uma API não testada para desenvolvedores de frontend e engenheiros de QA.
O caso acima demonstra que a qualidade do código diminui sem uma boa ferramenta. E agora, há uma ferramenta útil chamada Apidog que pode gerar o corpo da requisição automaticamente durante a depuração. A ferramenta pode construir um JSON de requisição correto sozinha.
Como Simular Corpos de Requisição
Essa abordagem funciona para equipes que usam API-first. APIs são projetadas antes do desenvolvimento, então, durante a depuração, você possui uma especificação da API.
1. Importe as especificações da API para o Apidog. (Como Simular Uma API?)
2. Abra uma API e certifique-se de que a requisição tenha uma especificação de corpo JSON/XML.
3. Mude para a aba "Executar" e clique no botão "Gerar Automaticamente". Você terá um JSON simulado de acordo com a especificação da requisição!
E agora clique em "enviar" para enviar a requisição como você fez no Postman, mas de forma mais eficiente. A maioria dos recursos do Postman também é suportada no Apidog. Nossa equipe usou o Apidog para depurar APIs em vez do Postman durante semanas.
O Que Mais
Observe os dados simulados. Eles foram gerados automaticamente de acordo com o nome do campo. Um campo chamado "cidade" é simulado com um nome de cidade, um campo chamado URL da foto é simulado com uma URL de foto, e todos os dados simulados seguem o esquema JSON especificado na API. Assim como no artigo anterior: Como simular JSON complexo.
E isso não é o fim. Passe o mouse sobre a seta ao lado de "Gerar Automaticamente", e você verá três itens de menu.
"Valor padrão primeiro" significa que o JSON simulado será preenchido pelo valor padrão especificado em cada campo da API primeiro. "Valor de exemplo primeiro" significa que o JSON simulado será carregado pelo JSON de requisição de exemplo primeiro. Mas o que significa "Atualizar ao enviar requisição"?
É apenas o significado literal. Cada vez que a requisição é enviada, o corpo é gerado novamente.
Como Personalizar Corpos de Requisição
Até agora, tudo parece ótimo. Mas e se alguns dos meus campos não estiverem esperando para mudar? Como posso fazer com que alguns campos sejam fixos e alguns simulados?
Clique no botão "Valor Dinâmico" e você encontrará um novo mundo.
Toda a sintaxe do Faker.js é suportada, e você pode selecionar qualquer uma delas diretamente. Você pode até selecionar uma função para modificar o valor simulado, como md5, substrato ou base64, etc.
Então, isso será inserido no corpo da requisição, assim como isto.
Você pode decidir qual campo é fixo e qual é simulado pelo Faker.js. Quando enviado, todos os campos do faker mudarão para os dados reais abaixo.
É isso. E muda a cada envio. Apidog é uma ótima ferramenta que faz nossa equipe construir APIs mais rápido.
