API и SDK / Введение в Web API

Введение в Web API

API ELMA365 — это инструментарий для интеграции ELMA365 со сторонними системами.

Общая информация

  • Всё API работает по протоколу HTTPS, путем выполнения POST-запросов.
  • Авторизация осуществляется по токену.
  • Все данные доступны только в формате JSON.
  • Базовый URL — https://{company}.elma365.ru/pub/v1.
  • Возможны запросы к данным из любой системы.

начало внимание

Размер веб запроса не может превышать 50 мегабайт

конец внимание

Ознакомиться с существующими функциями можно в статье «Web API». При необходимости пользователь может самостоятельно добавлять нужные методы API в модулях. Подробнее читайте в статье «Методы API в модулях».

Параметры запроса

Параметры запроса передаются:

  • В URL — идентификаторы.
  • В теле запросаметоды API.

В теле запроса укажите данные в формате JSON.

Более подробно ознакомиться с функциями в системе ELMA365 можно в статье «Web API».

Авторизация по токену

  • Токен передается в заголовке http-запроса.

«X-Token»: «4bece94a-d372-404f-a4be-fb159019d9e0»,

  • Для пользователя индивидуально создается токен и все запросы отправляются от имени пользователя.

Управление правами на API осуществляется с помощью токена.

Проверка запроса

В системе ELMA365 можно проверить запрос на работоспособность.

Для проверки запроса, нажмите на иконку __________.png рядом с названием Приложения и выберите пункт меню API.

введение в api 1

Перейдите на вкладку нужного метода и откройте вкладку Проверить. Затем введите тело запроса и нажмите на кнопку Отправить.

введение в api 2 365

Результат запроса отобразиться в поле Результат.

введение в api 3

Более подробно про существующие функции читайте в статье «Web API».

Нашли опечатку? Выделите текст, нажмите ctrl + enter и оповестите нас