// módulo spring boot · referência

API do projeto

Referência dos endpoints da API construída ao longo do módulo. É o que o módulo de front-end (React) vai consumir.

Em construção. Esta página é preenchida conforme as aulas avançam. Os exemplos abaixo mostram o formato que ela terá.

Como rodar

./mvnw spring-boot:run        # macOS / Linux
mvnw.cmd spring-boot:run      # Windows

Base da API: http://localhost:8080

Documentação interativa (Swagger), a partir da aula 4: http://localhost:8080/swagger-ui.html

Depois do login, envie o token em todas as requisições protegidas:

Authorization: Bearer <token>

Método	Rota	Descrição	Aula
`GET`	`/recursos`	Lista com paginação e filtros	6 e 7
`GET`	`/recursos/{id}`	Busca por id (404 se não existir)	4
`POST`	`/recursos`	Cria um registro (400 se inválido)	5
`PUT`	`/recursos/{id}`	Atualiza um registro	4
`DELETE`	`/recursos/{id}`	Remove um registro	4

Troque recursos pelo nome real das entidades do projeto.

GET /recursos?page=0&size=10&sort=nome,asc&status=ATIVO

Exemplo simplificado de resposta:

{
  "content": [ { "id": 1, "nome": "Exemplo", "status": "ATIVO" } ],
  "number": 0,
  "size": 10,
  "totalElements": 42,
  "totalPages": 5
}

{
  "status": 400,
  "mensagem": "Dados inválidos",
  "campos": { "nome": "não pode estar em branco" }
}