Pular para conteúdo

Aula 03 - Modelagem REST

*   `400 Bad Request`: Requisição inválida (falta de dados).
*   `401 Unauthorized`: Falta de autenticação.
*   `403 Forbidden`: Autenticado, mas sem permissão.
*   `404 Not Found`: Recurso não existe.
  • 5xx (Erro do Servidor):
    • 500 Internal Server Error: O servidor "quebrou".

5. O Formato JSON 🏗️

O JSON (JavaScript Object Notation) é o padrão de facto para troca de dados em APIs REST por ser leve e fácil de ler (por humanos e máquinas).

{
  "id": 123,
  "nome": "Smartphone X",
  "preco": 1500.00,
  "disponivel": true,
  "categorias": ["Eletrônicos", "Ofertas"]
}

6. Mini-Projeto: Desenhando um Contrato ✍️

Imagine que você está criando uma API para uma Biblioteca.

  1. Defina a URI para listar todos os livros.
  2. Defina a URI e o Verbo para cadastrar um novo livro.
  3. Qual Status Code você retornaria se alguém tentasse deletar um livro que não existe?
  4. Desenhe o JSON de um objeto "Livro" com pelo menos 5 campos.

7. Exercício de Fixação 🧠

  1. Diferencie PUT de PATCH com um exemplo prático.
  2. Por que não devemos usar verbos nas URIs (ex: /deletarUsuario/123)?
  3. O que significa uma API ser "Stateless"?

Próxima Aula: Vamos aprender a documentar essas APIs com Swagger e criar Mocks! 📝