springboot-todo-api

A clean Spring Boot REST API you can demo in minutes.

Features

• CRUD endpoints for TODO items
• Input validation
• H2 in-memory DB (easy local run)
• OpenAPI/Swagger UI
• Unit/integration tests with MockMvc

Prerequisites

• Java 17+
• Maven 3.8+

Run locally

cd springboot-todo-api
mvn spring-boot:run

API runs at:

• http://localhost:8080

Swagger UI:

• http://localhost:8080/swagger-ui.html

Example endpoints

• GET /api/todos
• POST /api/todos
• GET /api/todos/{id}
• PUT /api/todos/{id}
• DELETE /api/todos/{id}
• GET /api/health

Run tests

mvn test

Sample curl

curl -X POST http://localhost:8080/api/todos \
  -H "Content-Type: application/json" \
  -d '{ "title": "Build portfolio", "done": false }'