REST API для поиска необходимого продукта Axiom

Общие сведения

В этом документе описаны основные принципы работы с продуктовым API Axiom, позволяющие вам найти наиболее подходящий дистрибутив Axiom JDK. Если вас интересует техническая документация, перейдите к спецификации OpenApi (Swagger) для нашего API.

Спецификация OpenAPI

Получение токена для аутентификации

Для начала работы с API необходимо создать уникальный токен безопасности, который позволит системе понимать источник запросов. Токены создаются и хранятся в разделе «Поддержка» в личном кабинете пользователя.

Примечание: Для подробной информации о личном кабинете и портале поддержки см. документ “Инструкция по работе с порталом поддержки”.

REST API для поиска необходимого продукта Axiom

REST API для поиска продуктов Axiom позволяет программно находить необходимые дистрибутивы Axiom JDK по заданным критериям, таким как версия, архитектура, операционная система и т.д.

Получение списка поддерживаемых операционных систем и архитектур для Axiom JDK

Поисковое API позволяет получить список поддерживаемых архитектур и операционных систем

Архитектуры

URL: https://api.axiomjdk.ru/v1/axiom/architectures

Пример ответа в формате JSON: 
["x86"]

Пример команды на Bash: 
curl -H 'Authorization: Bearer $TOKEN' 'https://api.axiomjdk.ru/v1/axiom/architectures'

Пример команды на PowerShell: 
curl -H 'Authorization: Bearer $TOKEN' 'https://api.axiomjdk.ru/v1/axiom/architectures

Операционные системы

URL: https://api.axiomjdk.ru/v1/axiom/operating-systems

Пример ответа в формате JSON: 
["linux", "linux-musl", "macos", "windows"]

Пример команды на Bash: 
curl -H 'Authorization: Bearer $TOKEN' 'https://api.axiomjdk.ru/v1/liberica/operating-systems'

Пример команды на PowerShell: 
curl -H 'Authorization: Bearer $TOKEN' 'https://api.axiomjdk.ru/v1/liberica/operating-systems'

Поиск самого нового релиза Axiom JDK

В этом примере предполагается, что пользователь знает для какой архитектуры и операционной системы ведется поиск. Используя дополнительные уточняющие фильтры, можно сократить возвращаемый список.

URL: https://api.axiomjdk.ru/v1/axiom/releases?versionmodifier=latest&bitness=64&os=windows&arch=x86&package-type=zip&bundle-type=jdk&producttype=axiom-pro

Пример ответа в формате JSON: 
[
  {
    "filename": "axiomjdk-jdk-pro17.0.7+7-windows-amd64.zip",
    "downloadUrl": "https://download.axiomjdk.ru/axiomjdk-pro/17.0.7+7/axiomjdkjdk-pro17.0.7+7-windows-amd64.zip",
    "productType": "axiom-pro",
    "bitness": "64",
    "bundleType": "jdk",
    "packageType": "zip",
    "architecture": "x86",
    "os": "windows",
    "installationType": "archive",
    "updateType": "psu",
    "version": "17.0.7+7",
    "featureVersion": 17,
    "interimVersion": 0,
    "updateVersion": 7,
    "patchVersion": 0,
    "extraVersion": 0,
    "buildVersion": 7,
    "sha1": "57f1878f49ff254823aa9500e42c1d513d12091d",
    "size": 194777879,
    "latest": true,
    "latestLTS": true,
    "latestInFeatureVersion": true,
    "lts": true,
    "fx": false,
    "eol": false,
    "ga": true
  }
]

Пример команды на Bash: 
curl -H 'Authorization: Bearer $TOKEN' 'https://api.axiomjdk.ru/v1/axiom/releases?versionmodifier=latest&bitness=64&os=windows&arch=x86&package-type=zip&bundle-type=jdk&producttype=axiom-pro'

Пример команды на PowerShell: 
curl -H 'Authorization: Bearer $TOKEN' 'https://api.axiomjdk.ru/v1/axiom/releases?versionmodifier=latest&bitness=64&os=windows&arch=x86&package-type=zip&bundle-type=jdk&producttype=axiom-pro'

Поиск самого нового релиза Axiom JDK с долгосрочной поддержкой (LTS)

Как и в предыдущем примере, используем дополнительные уточняющие фильтры

URL: https://api.axiomjdk.ru/v1/axiom/releases?versionmodifier=latest&bitness=64&os=windows&arch=x86&package-type=zip&bundle-type=jdk&producttype=axiom-pro&release-type=lts

Пример ответа в формате JSON: 
[
  {
    "filename": "axiomjdk-jdk-pro17.0.7+7-windows-amd64.zip",
    "downloadUrl": "https://download.axiomjdk.ru/axiomjdk-pro/17.0.7+7/axiomjdkjdk-pro17.0.7+7-windows-amd64.zip",
    "productType": "axiom-pro",
    "bitness": "64",
    "bundleType": "jdk",
    "packageType": "zip",
    "architecture": "x86",
    "os": "windows",
    "installationType": "archive",
    "updateType": "psu",
    "version": "17.0.7+7",
    "featureVersion": 17,
    "interimVersion": 0,
    "updateVersion": 7,
    "patchVersion": 0,
    "extraVersion": 0,
    "buildVersion": 7,
    "sha1": "57f1878f49ff254823aa9500e42c1d513d12091d",
    "size": 194777879,
    "latest": true,
    "latestLTS": true,
    "latestInFeatureVersion": true,
    "lts": true,
    "fx": false,
    "eol": false,
    "ga": true
  }
]

Пример команды на Bash: 
curl -H 'Authorization: Bearer $TOKEN' 'https://api.axiomjdk.ru/v1/axiom/releases?versionmodifier=latest&bitness=64&os=windows&arch=x86&package-type=zip&bundle-type=jdk&producttype=axiom-pro&release-type=lts'

Пример команды на PowerShell: 
curl -H 'Authorization: Bearer $TOKEN' 'https://api.axiomjdk.ru/v1/axiom/releases?versionmodifier=latest&bitness=64&os=windows&arch=x86&package-type=zip&bundle-type=jdk&producttype=axiom-pro&release-type=lts'

Получение ссылки для скачивания дистрибутива Axiom JDK без разбора ответа в формате JSON

Этот пример показывает как получить ссылку для скачивания дистрибутива Axiom JDK без разбора ответа в формате JSON

URL: https://api.axiomjdk.ru/v1/axiom/releases?versionmodifier=latest&bitness=64&os=windows&arch=x86&package-type=zip&bundle-type=jdk&producttype=axiom-pro&output=text&fields=downloadUrl

Пример ответа: 
https://download.axiomjdk.ru/axiomjdk-pro/17.0.7+7/axiomjdk-jdk-pro17.0.7+7-windowsamd64.zip

Пример команды на Bash: 
curl -H 'Authorization: Bearer $TOKEN' 'https://api.axiomjdk.ru/v1/axiom/releases?versionmodifier=latest&bitness=64&os=windows&arch=x86&package-type=zip&bundle-type=jdk&producttype=axiom-pro&output=text&fields=downloadUrl'

Пример команды на PowerShell: 
curl -H 'Authorization: Bearer $TOKEN' 'https://api.axiomjdk.ru/v1/axiom/releases?versionmodifier=latest&bitness=64&os=windows&arch=x86&package-type=zip&bundle-type=jdk&producttype=axiom-pro&output=text&fields=downloadUrl'