Acervo.estudos
Trilhas Enviar material Entrar
mapa · Intermediário

4.5 Testando o servidor web

Como testar os endpoints da API com REST Client, curl, Postman e Insomnia: arquivo .rest, variáveis e requisições encadeadas, status esperados e os casos de erro que a aula não cobre.

por @julio · rev. 23 set · 5 telas

Navegador só faz GET

Ferramentas para testar uma API

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom

Instalação do REST Client: Extensões (Ctrl+Shift+X) → pesquisar "REST Client" → Instalar a de Huachao Mao. Com o servidor da aula 4.4 rodando, abra um arquivo .rest e clique em Send Request acima de cada requisição.

Variáveis, ### e requisições nomeadas

O arquivo tests/requests.rest

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
@baseUrl = http://localhost:8000

### Listar
GET {{baseUrl}}/users
Accept: application/json

### Criar
# @name criar
POST {{baseUrl}}/users
Content-Type: application/json

{ "nome": "Beatriz Teste", "email": "beatriz.teste@ifrs.edu.br" }

### Atualizar o que acabou de ser criado
PUT {{baseUrl}}/users/{{criar.response.body.$.id}}
Content-Type: application/json

{ "nome": "Beatriz Atualizada", "email": "beatriz.atualizada@ifrs.edu.br" }

### Excluir
DELETE {{baseUrl}}/users/{{criar.response.body.$.id}}

### Rota inexistente
GET {{baseUrl}}/nao-existe

⚠ A página original pede para criar a pasta "request" com um arquivo testes.rest, mas todos os passos seguintes editam /tests/requests.rest, que é o caminho da estrutura da aula 4.2.

⚠ O trecho do DELETE na página original começa com <?php. Isso não existe na sintaxe do REST Client: como vem antes do ###, a linha entra no corpo do PUT anterior e estraga o JSON dele. Apague essa linha.

-i mostra status e cabeçalhos

O mesmo roteiro com curl

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
curl -i http://localhost:8000/users
curl -i --json @novo.json http://localhost:8000/users
curl -i -X PUT --json @alterado.json http://localhost:8000/users/4
curl -i -X DELETE http://localhost:8000/users/4
curl -i http://localhost:8000/nao-existe
HTTP/1.1 201 Created
Host: localhost:8000
Date: Wed, 23 Sep 2026 19:14:59 GMT
Connection: close
X-Powered-By: PHP/8.4.0
Content-Type: application/json; charset=utf-8

{"id":"4","nome":"Beatriz Teste","email":"beatriz.teste@ifrs.edu.br"}

O servidor embutido do PHP inclui Host nos cabeçalhos da resposta; em Apache ou Nginx ele não aparece. O REST Client formata o JSON; o curl mostra o corpo cru, numa linha.

Teste também o caminho do erro

O que os testes revelam

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
RequisiçãoProjeto da aula (testado)Esperado
POST com e-mail já cadastrado200 + Fatal error em HTML409 + JSON
PUT /users/999200 "atualizado com sucesso"404
DELETE /users/999200 "excluído com sucesso"404
PUT só com e-mail200 + Fatal error (nome NULL)422
PATCH /users/1405405 + Allow
DELETE /users/4 (existe)200 + mensagem204 ou 200

⚠ Nas saídas da página original, o GET devolve "id": 1 (número) e o POST devolve "id": "4" (texto). O mesmo campo muda de tipo porque lastInsertId() retorna string; converta com (int) antes de responder.

Teste antes de seguir

Revisão rápida

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
Como testar um DELETE sem Postman nem VS Code?

Com curl: curl -i -X DELETE http://localhost:8000/users/4.

Para que serve o ### no arquivo .rest?

Separa uma requisição da outra; cada bloco ganha o seu link Send Request.

Um DELETE de id inexistente respondeu 200 "excluído com sucesso". O que está errado no backend?

O modelo devolve o resultado de execute(), que é true mesmo sem linha apagada. Deve olhar rowCount() e responder 404 quando for 0.

Por que evitar @userId = 4 fixo no arquivo de testes?

O id depende de quantas vezes o POST já rodou. Nomeando o POST (# @name criar) e usando {{criar.response.body.$.id}}, o PUT e o DELETE usam o id realmente criado.

← Voltar ao curso