Postman - Guia Básico

O Postman é uma ferramenta poderosa para testar APIs, facilitando o envio de requisições HTTP e a análise de respostas. Ele permite testar endpoints sem a necessidade de acessar um sistema completo, tornando o processo mais ágil e eficiente.

Este guia apresenta um passo a passo detalhado sobre como utilizar o Postman para realizar requisições e depurar problemas.

CONCEITOS BÁSICOS DE REQUISIÇÕES HTTP:

Antes de usar o Postman, é essencial entender os métodos HTTP mais comuns:

GET: Recupera informações de um servidor.

POST: Envia dados para o servidor para criar novos registros.

PUT: Atualiza registros existentes no servidor.

DELETE: Remove um registro do servidor.

Exemplo:

GET /parceiros → Retorna a lista de parceiros cadastrados.

POST /parceiros → Cadastra um novo parceiro enviando dados no corpo da requisição.

ESTRUTURA DE UMA REQUISIÇÃO NO POSTMAN:

Uma requisição no Postman é composta pelos seguintes elementos:

a) URL (Endpoint)

A URL define o endereço do servidor e o recurso que será acessado. Ela pode conter:

Host: Exemplo, https://api.meuservico.com

Endpoint: O recurso desejado, como /clientes ou /pedidos.

Parâmetros: Informações enviadas na URL, como ?id=123.

b) Headers

Os headers contêm metadados importantes, como:

Authorization: Token de autenticação.

Content-Type: Define o formato dos dados (application/json).

c) Body

O corpo da requisição (Body) contém os dados enviados ao servidor, geralmente em formato JSON.

Exemplo de corpo para um POST /parceiros:

{
  "nome": "Empresa XYZ",
  "cnpj": "12.345.678/0001-99",
  "endereco": "Rua Exemplo, 123"
}

COMO CONFIGURAR E EXECUTAR UMA REQUISIÇÃO NO POSTMAN:

Abrir o Postman e Criar uma Nova Requisição: Abra o Postman, clique em New Request, escolha o método HTTP (GET, POST, PUT, DELETE) e insira a URL do endpoint.

Configurar os Headers: Vá até a aba Headers e adicione informações importantes, como o Authorization: Bearer.