В ASAP можно обращаться из сторонних решений с помощью Open API. Open API работает через HTTP и представляет набор методов запрос/ответ.
API-запросы необходимо отправлять по следующему адресу:
<URL портала ASAP, используемого для взаимодействия через Open API>/openapi/<Версия API>/<запрос>
Как получить URL ASAP, используемого для взаимодействия через API
Чтобы получить ASAP Open API URL:
Как включить доступ по API и сгенерировать токен
Для авторизации запросов их необходимо подписывать токеном, созданном в платформе ASAP. Только администраторы компании могут создать токены.
Чтобы создать токен:
Откроется окно Получить токен.
Токен не хранится в системе ASAP в открытом виде. После закрытия окна Получить токен он становится недоступным для просмотра. Если вы закрыли это окно, не скопировав токен, вам требуется нажать на кнопку Новый токен повторно, чтобы система сгенерировала новый токен.
Выпущенный токен действителен в течение 12 месяцев. По истечении этого срока токен будет отозван. Выпущенный токен будет также отозван, если он не используется в течении 6 месяцев.
Авторизация
Полученный в ASAP токен необходимо добавлять в заголовки всех API-запросов. Заголовок должен выглядеть следующим образом:
|
Формат ответа
JSON является поддерживаемым по умолчанию форматом ответов на API-запросы.
Пример CURL-вызова
Ниже показан API-запрос на адрес https://domain.com/, в котором используется метод GET openapi/v1/groups (получение списка групп). В запросе используется авторизация токеном e8c699c05d495566a94bbb6841894153
.
|
Методы ASAP Open API, используемые для интеграции с системами управления обучением (LMS)
Доступные методы интеграции с системами управления обучением:
Допустимая нагрузка каждого метода составляет не более 10 запросов в секунду (RPS).