GET единиц преобразования
Материал из Документация Ключ-АСТРОМ
Версия от 16:25, 10 октября 2022; ENetrebin (обсуждение | вклад) (Новая страница: «Возвращает свойства метрической единицы измерения. Если целевая единица измерения не з...»)
Возвращает свойства метрической единицы измерения.
Если целевая единица измерения не задана, запрос автоматически находит соответствующую целевую единицу измерения с учетом предпочтительного числового формата (если указан).
Запрос выдает application/json
полезную нагрузку.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/units/{unitId}/convert
|
Среда АктивногоШлюза | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/units/{unitId}/convert
|
Аутентификация
Для выполнения этого запроса вам нужен токен доступа с областью чтения metrics (metrics.read
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация.
Параметры
Параметр | Тип | Описание | In | Необходимость |
---|---|---|---|---|
unitId | string | Идентификатор исходной единицы измерения. | path | требуется |
value | number | Значение, подлежащее преобразованию. | query | требуется |
targetUnit | string | Идентификатор целевой единицы измерения. | query | необязательно |
numberFormat | string | Предпочтительный формат чисел. Учитывается только в том случае, если не указана целевая единица измерения. | query | необязательно |
Ответ
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | Result | Успех |
404 | Не найдено. Запрошенный ресурс не найден или запрос неверен. |
Объекты тела ответа
Объект UnitConversionResult
Результат преобразования единиц измерения.
Элемент | Тип | Описание |
---|---|---|
unitId | string | Идентификатор единицы измерения этого результата преобразования. |
resultValue | number | Результат преобразования единиц измерения. |
JSON-модель тела ответа
{
"unitId": "string",
"resultValue": 1
}