m-davies/openjdk-api-v3

AdoptOpenJDK API V3 🚀

AdoptOpenJDK API

NOTICE: AdoptOpenJDK API v1 has now been removed. If you are using v1 please move to the latest version (documented below) as soon as possible.

NOTICE: AdoptOpenJDK API v2 has been deprecated and will be removed. If you are using v2 please move to the latest version (documented below) as soon as possible.

Overview

The AdoptOpenJDK API provides a way to consume JSON information about the AdoptOpenJDK releases and nightly builds.
Sign up to the mailing list where major API updates will be announced, and visit adoptopenjdk.net to find out more about the community.

To learn more about how we build & run the API, check out CONTRIBUTING.md and the FAQs.

Usage

The API is documented via swagger. The swagger documentation can be viewed at: swagger-ui. The open api definition for this can be viewed at openapi.

For more information, including example queries, please look at STRUCTURE.md

Who's using the AdoptOpenJDK API?

The AdoptOpenJDK API has served over 200 million downloads by a wide variety consumers, from individuals to organisations.

Check the Download Statistics Dashboard for the latest numbers.

The following list highlights a small subset of consumers and their use-cases:

• AdoptOpenJDK Website - the API drives the release listings on the AdoptOpenJDK website allowing individuals to download the JDK distribution of their choice
• AdoptOpenJDK Docker Images - the API is used during the creation of the various official & unofficial Docker images
• Gradle - the Gradle project defaults to use the API for its toolchains feature
• Update Watcher for AdoptOpenJDK - uses the API to automatically manage the JDK installations on an individual's machine