O que é uma API?

Antes de falar do Postman, é importante que entendamos o conceito de uma API. Seu significado é Application Program Interface ou Interface de Programação de Aplicação. Podemos resumir como sendo o contrato entre quem precisa e quem fornece os dados. Um exemplo seria um pedido de um restaurante: quando escolhemos algo do cardápio, o garçom solicita à cozinha o preparo, como a cozinha vai preparar não interessa ao garçom nem ao solicitante do pedido, de forma análoga, é uma chamada de API com a solicitação de nosso pedido.

Existem diversos protocolos de API, neste artigo estamos focado em

• Aberta/pública: desenvolvidas como objetivo de transacionar facilmente dados em ambientes virtuais públicos (Facebook, Google Maps, Youtube, etc.).
• Interna/privada: desenvolvidas para transacionar dados de forma interna, dentro do sistema de uma organização (Internet Banking, Assistentes Virtuais, Governo, etc.).
• Parceiros: desenvolvida para integrações entre empresas (ERP integrando uma NF).

Existem diversos protocolos de API, neste artigo estamos focado em APIs REST e dentro destes protocolos existem alguns tipos:

• URL: é o caminho para o recurso, ou seja, o endereço que será requisitado. Conhecido como endpoint.
• Método: são os métodos HTTP que informam a ação a realizar: GET, POST, PUT, DELETE, etc.
• Header: contém as informações da requisição, tanto do que se envia quanto do que se recebe.
• Body: corpo onde estará carregando dados de envio e recebimento,  JSON, XML, etc.

O Postman

É uma ferramenta que dá suporte à criação e uso de APIs. Simplifica cada etapa do ciclo de vida da API e agiliza a colaboração para que você possa criar APIs melhores com mais rapidez.

A ferramenta oferece recursos para desenvolvimento, testes e documentação, tornando a construção de APIs mais ágil, rápida e segura. Além disso, é possível salvar as requisições evitando a escrita do código a cada teste/execução. O ambiente gráfico oferecido pela ferramenta propicia mecanismos de análise e formatação dos dados de retorno.

Para aprender mais sobre a ferramenta, a documentação do próprio Postman é bem completa e pode ser acessada aqui.

Além disso, o Oclécio gravou um BE.TECH sensacional sobre o assunto:

Gostou deste post? Deixa seu comentário, te vejo na próxima publicação, um abraço,

Danton C. Franco Junior

#TimeTec