Lookup API

This sample demonstrates a simple lookup backend using .NET 8, Clean Architecture, CQRS with MediatR and Keycloak authentication.

Projects

• Domain – entity definitions and repository interfaces.
• Application – MediatR queries and DTOs.
• Infrastructure – EF Core context and repository implementations.
• API – ASP.NET Core Web API.

Running with Docker

docker-compose up --build

The API will be available at http://localhost:5000/swagger.

Keycloak Users

• admin / admin – Admin role
• viewer / viewer – Viewer role

Requesting a Token

1. Open Swagger UI and use the Authorize button.
2. Login with one of the users above.

Example Requests

• GET /api/countries
• GET /api/cities?countryId=1
• GET /api/colors

All endpoints require a valid JWT token obtained from Keycloak.