Доступно начиная с версии ExeMES 2.4

ExeMES Media Service - это сервис для работы с файлами в ExeMES.

API ExeMES Media Service предоставляют следующие возможности:

  • загрузка и публикация файлов, в том числе версионирование;
  • просмотр файлов в web-интерфейсе, в том числе просмотр истории версий файлов и ранее опубликованных версий файлов;
  • удаление файлов или их отдельных версий;
  • выгрузка файлов.

ExeMES Media Service используется ExeMES Client и ExeMES RuntimeClient. ExeMES Media Service также может использоваться сторонними приложениями путем вызова web API.

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

Вызов web API ExeMES Media Service

Вызов web API ExeMES Media Service можно реализовывать различными способами в зависимости от способов и методов реализации на стороне клиентских приложений.

Пример вызова web API функции Files, возвращающей список всех файлов в ExeMES:

var myHeaders = new Headers();
var accessToken = "token"; // здесь необходимо задать Access Token, полученный от KeyCloak
myHeaders.append("Authorization", `Bearer ${accessToken}`);
 
var requestOptions = {
  method: 'GET',
  headers: myHeaders
};
 
fetch("https://exemedia.[домен]/api/Files", requestOptions)
  .then(response => response.json())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://exemedia.[домен]/api/Files");
var accessToken = "token"; // здесь необходимо задать Access Token, полученный от KeyCloak
request.Headers.Add("Authorization", $"Bearer {accessToken}");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Документация по web API ExeMES Media Service

ExeMES Media Service использует бесплатные инструменты Swagger в качестве встроенного инструмента документирования web API.

Swagger — это набор инструментов, который позволяет автоматически описывать API на основе его кода. На основе кода Swagger автоматически генерирует документацию в формате JSON-файла. Ее можно встроить на страницу сайта или в приложение, чтобы пользователи могли интерактивно знакомиться с документацией.

Документация по web API ExeMES Media Service доступна в Swagger по адресу https://exemedia.[домен]/swagger/index.html. В интерфейсе swagger представлен список всех доступных web API функций ExeMES Media Service с описанием.

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

Для авторизации в Swagger необходимо нажать на кнопку «Authorize», размещенную в правом верхнем углу основной страницы, после чего в открывшемся окне нажать на кнопку «Authorize».

Далее вы будете перенаправлены на страницу входа и после успешного прохождения авторизации API функции будут доступны для вызова из Swagger. Swagger предоставляет информацию о назначении каждой функции и каждого параметра функции.

Для вызова функции необходимо нажать на кнопку «Try it out» в выпадающей области, после чего задать необходимые параметры функции и нажать на кнопку «Execute». В случае успешного выполнения функции, возвращаемые функцией данные станут доступны в поле «Response body»:

При неуспешном выполнении функции в Server response будет предоставлена информация об ошибке:

Swagger используется только при разработке и тестировании прикладного ПО и не должен использоваться для каких-либо пользовательских функций в продуктивных средах. API функции ExeMES Media Service должны вызываться в клиентских приложениях с использованием встроенных средств на стороне клиентских приложений.