API(calculadora) com Node.js e Swagger

Neste tutorial vamos fazer uma API de uma calculadora (só com soma) com Node.js e Swagger.

Swagger UI é um projeto de linguagem aberta para renderizar visualmente documentação de uma API definida como OpenAPI (Swagger).

Primeiro vamos criar uma pasta para o nosso projeto com o nome calculadora_swagger, de seguida abrimos a linha de comandos e inserimos o seguinte comando:

npm init

Depois vamos instalar as dependências (express.js e swagger-ui)

npm install express

npm i swagger-ui-express -S

Após isso vamos criar o ficheiro index.js e inserir o seguinte código:

Em seguida vamos criar o ficheiro swagger.json com o código seguinte:

Por fim vamos correr a nossa API

node index.js

Agora é só abrir o endereço http://localhost:8001/api-docs/ e deverão ter algo semelhante a isto:

Para testar se está tudo a funcionar basta clicar no GET, depois Try out, inserir dois números e Execute.

Para conferir o resultado é só conferir o Response body:

E pronto se seguiu todos os passos e obteve o mesmo resultado, parabéns chegou ao final deste tutorial.