Category Archives: Tools

Tools – Postman

WebApp Saga

O Postman foi projetado para permitir a realização de requisições HTTP GET, POST, PUT, DELETE, etc, a partir de uma interface simples e intuitiva, facilitando o teste/debug dos serviços REST.

De autoria do Google, e instalado a partir da Chrome Web Store.

HTTP GET

PostMan, use o método GET e retorne todos os clientes.

http://localhost:3000/clientes/

Para certificar a operação, note o resultado do Status 200 OK e do Body.

HTTP PUT

PostMan, use o método POST e crie um novo cliente.

http://localhost:3000/clientes/

Para certificar a operação, note o resultado do Status 201 Created e do Body.

HTTP PUT

PostMan, use o método PUT e faça a alteração dos dados do cliente com id 4.

http://localhost:3000/clientes/4

Para certificar a operação, note o resultado do Status e do Body.

Http Delete

PostMan, use o método delete e remova o cliente com id igual a 2.

http://localhost:3000/clientes/2

Para certificar a operação, note o resultado do Status e do Body.

URLS com mais parâmetros

Também podemos extender nossas URLS com mais parâmetros.

A chamada será:

http://localhost:3000/clientes?nome=Aldo

Este exemplo aplica um filtro usando um parâmetro na URL.

Faker

Mock os dados em seu servidor com o faker.

Note que o JSON Server atende na porta 3000, e um app Angular padrão atende na porta 4200.

Em outro post, abordarei como acessar um serviço fake a partir de um app Angular.

Links: https://www.npmjs.com/package/Faker

Missão cumprida!

 

 

 

Tools – API Design

WebApp Saga

Ferramentas: API Editor Design

Continuando a série sobre ferramentas úteis que nos auxiliam no desenvolvimento de aplicações.

A partir de agora vamos APRESENTAR alguns API DESIGNER. Vamos lá:

Uma API Design é uma ferramenta projetada para simplificar e oferecer um ambiente de desenvolvimento, design e teste de APIs.

Em termos funcionais, elas são responsáveis:

  • Expansão o ciclo de vida
  • Realçar o design saudável
  • Permitir que provedores de APIs conversem com os desenvolvedores sobre o design da API antes que o desenvolvimento se inicie efetivamente

Um simples design de API

  • Documentação atualizada e completa
  • Boas práticas de desenvolvimento
  • Formatos consolidados

O que ganhamos durante todo o ciclo de vida de uma API.

Linguagens de APIs e ferramentas estão sendo desenvolvidos muito rapidamente.

Apiary.io

  • Design colaborativo
  • Simulação instantânea
  • Documentação
  • Exemplos integrados
  • Debug
  • Testes automatizados (formato de definição API Blueprint)

Tela inicial do Apiaryio.

Swagger

  • Formatos de definição YAML e JSON.
  • Importar, editar, pré-visualizar e exportar documentação do design de APIs

API Designer

  • Formatos de definição RAML
  • Simulação
  • Pré-visualizar
  • Salvar designs de APIs
  • Integração com outras ferramentas MuleSoft.

Restlet Studio

  • Formatos de definição do Swagger e RAML
  • Gera códigos base para os servidores e SDK clientes em várias linguagens

Postman

Não é uma ferramenta de design. Porém, é muito utilizada para simulações de APIs.

  • Teste colaborativo com diversos recursos das APIs
  • Suporte Autenticação
  • Suporte Cabeçalhos
  • Gera Formatos
  • Gera códigos base de uso da API para clientes em várias linguagens.

A explosão de APIs

Hoje, os desenvolvedores precisam criar APIs para outros desenvolvedores parceiros, para o público, para coleta de dados, para tratar a lógica de negócio, considerando as plataformas de desenvolvimento, as plataformas de infra estrutura, a experiência do usuário e as interfaces dos usuários.

Pronto! Agora temos uma noção de API Design.

Missão cumprida!