f5a419024e | ||
---|---|---|
.mvn/wrapper | ||
src | ||
.env | ||
.gitignore | ||
Dockerfile | ||
README.md | ||
docker-compose.yml | ||
mvnw | ||
mvnw.cmd | ||
pom.xml |
README.md
OpenAIRE Search API v2
Welcome to the OpenAIRE Search API v2 code repository!
This repository houses the latest implementation of our OpenAIRE Search API, designed to facilitate seamless access to metadata records of research products (i.e., publications, data, software, other research products), and projects within the OpenAIRE Graph.
For more information, please take a look at our documentation page.
Getting Started
Reference for developers
-
This project is built with Java 21; tested using OpenJDK 21.0.2.
-
Before starting the application, please load env variables from
.env
file. If you are using IntelliJ, you can do that by navigating toRun -> Edit Configurations -> Modify Options
, checkEnvironment variables
underOperating Systems
, and append the env variables with a semicolon separator.
Docker support
Create a docker image using:
# building the jar file
mvn install
# building the actual docker image
docker build -t openaire-search-api-v2:latest .
Start a docker container as follows:
# load required env variables
source .env
# start docker container
docker run -it -p 8080:8080 openaire-search-api-v2:latest .
or using docker compose:
# adjust env variables in docker-compose.yml
# start container using docker compose
docker compose up -d
In both case, Swagger should be accessible at ${OPENAPI_SERVER_BASE_URL}/swagger-ui/index.html#/
or http://localhost:8080/swagger-ui/index.html#/ inf you are running it on localhost.