GET расширения

Материал из Документация Ключ-АСТРОМ

API Ключ-АСТРОМ / Эндпойнты среды / Развёртывание / Расширения 2.0 / Раширения / GET расширения

Функция выводит список свойств указанного расширения Extensions 2.0 или загружает ZIP-файл расширения.

Запрос создает один из следующих типов полезной нагрузки, в зависимости от значения заголовка запроса Accept :

  • application/json— полезная нагрузка JSON, содержащая свойства расширения.
  • application/octet-stream— загрузка ZIP-файла расширения.

Если с запросом не предоставлен заголовок Acceptapplication/json , возвращается полезная нагрузка.

GET Managed https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/{extensionVersion}
Среда АктивногоШлюза https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/{extensionVersion}

Аутентификация

Чтобы выполнить этот запрос , вам нужен токен доступа с областью действия Read extensions ( extensions.read) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

Параметры

Параметр Тип Описание In Необходимость
extensionName string Имя запрошенного расширения 2.0. path требуется
extensionVersion string Версия запрашиваемого расширения 2.0 path требуется
Accept string Принять заголовок. Указывает часть расширения 2.0, которая будет возвращена:
  • приложение/json; charset=utf-8 — возвращает метаданные расширения 2.0 в JSON
  • application/octet-stream — возвращает zip-архив с расширением 2.0, хранящийся на сервере.
заголовок по желанию

Ответ

Коды ответов

Код Тип Описание
200 Extension Успех
404 ErrorEnvelope Не удалось. Запрошенный ресурс не существует.
406 ErrorEnvelope Неприемлимо

Объекты тела ответа

Объект ResponseBody

Элемент Тип Описание
имя_расширения string Имя расширения

Может быть null.

version string Версия расширения

Может быть null.

author AuthorDto Автор расширения

Может быть null.

dataSources string[] Источники данных, которые расширение использует для сбора данных

Может быть null.

переменные string[] Пользовательские переменные, используемые в конфигурации расширения

Может быть null.

наборы функций string[] Доступные наборы функций

Может быть null.

featureSetsДетали object Подробная информация о наборах функций

Может быть null.

minAstromkeyVersion string Минимальная версия Ключ-АСТРОМ, которая работает с расширением

Может быть null.

fileHash string Хэш SHA-256 загруженного файла расширения

Может быть null.

Объект AuthorDto

Автор расширения

Элемент Тип Описание
name string Имя автора

Может быть null.

Объект FeatureSetDetails

Дополнительная информация о наборе функций

Элемент Тип Описание
metrics MetricDto[] Показатели набора функций

Может быть null.

Объект MetricDto

Метрика, собранная расширением

Элемент Тип Описание
key string Метрический ключ

Может быть null.

metadata MetricMetadataDto Метаданные показателей

Может быть null.

Объект MetricMetadataDto

Метаданные показателей

Элемент Тип Описание
displayName string Название метрики в пользовательском интерфейсе

Может быть null.

description string Краткое описание метрики

Может быть null.

unit string Единица измерения

Может быть null.

JSON-модель тела ответа

{
  "extensionName": "string",
  "version": "1.2.3",
  "author": {
    "name": "string"
  },
  "dataSources": [
    "string"
  ],
  "variables": [
    "string"
  ],
  "featureSets": [
    "string"
  ],
  "featureSetsDetails": {},
  "minAstromkeyVersion": "string",
  "fileHash": "string"
}