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.
Ferramentas para testar uma API
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.
O arquivo tests/requests.rest
@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.
O mesmo roteiro com curl
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-existeHTTP/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.
O que os testes revelam
| Requisição | Projeto da aula (testado) | Esperado |
|---|---|---|
| POST com e-mail já cadastrado | 200 + Fatal error em HTML | 409 + JSON |
| PUT /users/999 | 200 "atualizado com sucesso" | 404 |
| DELETE /users/999 | 200 "excluído com sucesso" | 404 |
| PUT só com e-mail | 200 + Fatal error (nome NULL) | 422 |
| PATCH /users/1 | 405 | 405 + Allow |
| DELETE /users/4 (existe) | 200 + mensagem | 204 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.
Revisão rápida
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.