GLVD API

This repo implements the HTTP API for GLVD.

Note

This is heavily work in progress.

Local Setup

Required/recommended software:

• SAPMachine JDK 21
• Podman Desktop/Machine
• Podman Compose

A local setup including the database with sample data can be setup using podman compose.

This requires building the jar file first.

See compose-up.sh for the required steps to bring up a local environment.

After about a minute you should be able to perform an HTTP GET request on http://localhost:8080/readiness and get a response with status code 200.

Example Requests

Find example requests to play with the API in the api-examples folder. They are created with Bruno, an open source and easy to use HTTP client.

API Docs

The API is documented here.

Those requests and responses are generated from tests automatically using Spring REST Docs. Note that you will need to adapt the hostname given in those docs.

Running the Tests locally

GLVD API uses testcontainers to bring up the database automatically. For running it with podman, some setup is needed as described here.

Running test-on-mac-with-podman.sh should work on macos with podman and a jdk set up.