Nos dias de hoje, grande parte dos desenvolvedores precisam fazer requisições a APIs, serviços externos, etc, para que alguma ação seja feita ou que algum dado seja retornado. No presente artigo, será demonstrado como utilizar uma ferramenta do gerenciador de pacotes NPM para uma carga “fake” de testes em sua aplicação, utilizando o json-server.
Para começar, é necessário instalar a dependência em seu projeto. Utilizando o prompt de comando, o Windows PowerShell, o terminal (para usuários de Linux e Mac), ou utilizando o próprio terminal de seu editor de código (Visual Studio Code), você deve navegar até a pasta raiz de seu projeto e digitar o comando:
npm i json-server
Exemplo no VS Code:
Após digitar o comando na pasta raiz de seu projeto, apertar ENTER em seu teclado e aguardar a instalação desse módulo.
Com a instalação concluída, você irá criar sua estrutura JSON em um arquivo dentro de sua aplicação. A estrutura JSON possui sempre uma chave e um valor, como por exemplo:
“nome”: “Mariana”;
No exemplo acima, a chave seria o nome e o valor seria a palavra Mariana.
O arquivo poderá ser de temas diversos, como produtos, flores, do que você quiser. No exemplo abaixo, o arquivo chama animais.json, com as chaves:
- id: que seria um identificador único para cada animal;
- nome: que seria o nome que o animal possui, se ele é um hamster, um crocodilo, etc;
- patas: que seria a quantidade de patas que um animal possui;
- classe: por fim, a classe dele, se é um mamífero, um réptil, uma ave, etc.
O arquivo será o seguinte:
- No arquivo, antes da inserção de dados, é necessário declarar uma variável do que será testado, no caso “animais”, mas podia ser “vasos”, “presentes”, etc;
- Cada conjunto de dados, que una chave e valor, irá dentro de chaves {}, separados por vírgulas;
- As chaves e os valores precisam estar entre aspas, a não ser no caso de números inteiros (2, 3, 5, 66);
Para gerar uma API fake a partir deste arquivo animais.json, você irá na pasta onde o arquivo .json está localizado e digitar o seguinte comando e apertar ENTER:
npx json-server animais.json
- No caso, o segundo parâmetro seria o nome do seu arquivo que, no exemplo deste documento é o arquivo animais.json
Feito isso, irá aparecer um link para você acessar em seu navegador:
Você pode copiar ele e colar ele na barra de endereços do navegador de sua preferência, ou, clicar no link apertando a tecla CTRL em seu teclado (ambas ações ao mesmo tempo), que será aberto seu JSON em sua máquina, localmente:
Agora, que sua API já está disponível no servidor local de sua máquina, você pode utilizar a URL: http://localhost:3000/animais em softwares como o Postman e o Insomnia, para fazer requisições para essa API.
