fosbsb/tax-api repository overview

⁠tax-api

A sample REST API that provides tax rates by Brazilian state (UF) and barcode, packaged as a Docker image.

Source code: https://github.com/fosbsb/tax-api⁠

⁠Build the image

docker build -t tax-api .

⁠Run with Docker

docker run --rm -p 8082:8082 --name tax-api tax-api

⁠Available endpoints

⁠API

Base URL:

http://localhost:8082

⁠Swagger UI

• http://localhost:8082/swagger-ui.html
• http://localhost:8082/swagger-ui/index.html

⁠OpenAPI

• http://localhost:8082/v3/api-docs

⁠H2 Console

• http://localhost:8082/h2-console

Connection settings:

• JDBC URL: jdbc:h2:mem:tax-db
• User: sa
• Password: (empty)

⁠Sample REST endpoints

• GET /produtos – List all barcodes and their tax rates by state.
• GET /produto/codigoBarras/{codigoBarras} – Retrieve tax rates for a specific barcode.