Desenvolvedores front-end costumam enfrentar esse problema. A API está projetada, mas ainda não foi implementada. Preciso criar alguns dados falsos para minha interface, o que significa que tenho que configurar um servidor simulado e adicionar alguns exemplos de resposta. Se não houver exemplos de resposta na documentação da API, devo inventar alguns dados de resposta eu mesmo.
Toda vez que faço isso, penso que não é o que um desenvolvedor front-end deveria fazer.
Deveria haver uma maneira melhor de realizar isso.
Eu experimentei muitas ferramentas. Usei o postman como um servidor simulado, mas todos os dados de resposta devem ser adicionados manualmente. Tentei o faker.js, mas tenho que escrever código de simulação para cada campo.
Na minha expectativa, um excelente servidor de simulação deveria gerar dados por conta própria. Os desenvolvedores deveriam se concentrar nas coisas realmente essenciais.
Ótima notícia: Agora, você pode simular uma API em apenas um minuto. E você não precisa escrever nenhum script.
Por que simular
A simulação é uma boa escolha se você estiver em uma das seguintes situações.
- A API está projetada, mas não desenvolvida. Isso geralmente acontece em equipes ágeis.
- APIs restritas ou pagas. Por exemplo, APIs de banco. Você não pode obter dados reais antes que o desenvolvimento seja concluído. Então você precisa de dados simulados.
- Ambiente offline ou intranet. Dados simulados permitem que você trabalhe em uma máquina local.
Vamos simular
Existem duas etapas para simular a API.
- Importar definições da API.
- Obter a URL simulada.
Tão fácil. Vamos simular!
Passo 1 - Importar definições da API
A documentação da API é necessária. OpenAPI (Swagger) é o melhor, e qualquer outro formato também é aceitável.
Suponha que você tenha um arquivo YAML ou JSON. Vamos importá-lo para esta ferramenta: Apidog. Se você ainda não tem uma API, também pode criá-la no Apidog.
1.Crie um novo projeto no Apidog.
2.Vá para "Configurações"-"Importar", e arraste seu arquivo de API para dentro.
Mais de dez formatos de documentação da API são suportados. Clique em "Avançar" e sua API será importada.
Agora você verá as APIs no Apidog.
Passo 2 - Obter a URL simulada
1.Clique em uma API no Apidog. Você verá uma página de definição da API, na qual há uma seção chamada "Simulação".
2.Clique na URL na parte "Simulação Local" que começa com "127.0.0.1" para copiá-la.
3.Cole-a no seu navegador.
OK, está feito! Você verá um JSON simulado!
Um campo "cidade" é preenchido com um nome de cidade, um campo "id" é preenchido com um número inteiro, e "createdAt" é preenchido com uma data-hora.
Agora você pode usar os dados da API em seu App.
E você não precisa escrever nenhum script! Os dados em todos os campos são gerados automaticamente.
Além disso, se você clicar em "recarregar" no navegador, os dados serão atualizados!
Incrível.
Como funciona
Na primeira vez que encontrei esse recurso, fiquei bastante surpreso. Por que o Apidog pode gerar isso? Eu não configurei nada!
Depois descobri isso.
Há um conjunto de regras de simulação integradas no Apidog, como as acima. Se o nome do seu campo na definição de resposta corresponder a uma delas, os dados do campo serão simulados automaticamente.
E o Apidog inicia um servidor simulado na sua máquina local automaticamente. Portanto, você não precisa fazer nada na camada do servidor.
E se você não gostar dos dados que ele simula automaticamente? Isso também é fácil.
Você pode preencher diretamente o valor simulado do campo com Faker.js assim.
Toda a gramática do Faker.js é suportada, para que você possa selecioná-la facilmente.
E se algum campo tiver um valor fixo, você também pode preencher o "mock" com o valor especificado.
Pronto, tudo feito.
Espero que você simule alegremente com Apidog.
É realmente uma boa ferramenta. E descobri que não é apenas boa para simulação, mas para tudo no desenvolvimento de API.
