Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ricpalomino/spring-boot/llms.txt

Use this file to discover all available pages before exploring further.

The Spring Boot Products API provides a complete RESTful interface for creating, reading, updating, and deleting products. Built on Spring Boot 4.0 with Java 17, it features a layered architecture, in-memory storage, request validation, and auto-generated Swagger UI — giving you a working API out of the box with clean extension points for swapping in a real database.

Quickstart

Run the API locally and make your first request in minutes.

Architecture

Understand the layered design and Strategy Pattern service implementations.

API Reference

Explore all six product endpoints with request and response schemas.

Error handling

Learn how errors are structured and what status codes to expect.

​
What’s included

CRUD endpoints

GET, POST, PUT, and DELETE operations at /api/v1/products with a consistent ApiResponse envelope.

Filtering

Filter products by name and price range using optional query parameters.

Validation

Jakarta Bean Validation on all request bodies with field-level error messages.

OpenAPI / Swagger UI

Interactive API explorer available at /swagger-ui.html with no extra configuration.

​
Get started

1

Clone and build

Clone the repository and build the project with Maven.
git clone https://github.com/ricpalomino/spring-boot.git
cd spring-boot
./mvnw clean install
2

Run the application

Start the server on port 8080.
./mvnw spring-boot:run
3

Explore the API

Open the Swagger UI in your browser to browse and test all endpoints interactively.
http://localhost:8080/swagger-ui.html
4

Make your first request

Create a product with a POST request.
curl -X POST http://localhost:8080/api/v1/products \
  -H "Content-Type: application/json" \
  -d '{"name": "Widget Pro", "price": 49.99}'

Build docs developers (and LLMs) love

Get started for freeTalk to us