Получение данных портфолио через внешние службы
Суть разработки
Добавление возможности получения данных по портфолио из СЭО 3КL удаленно, запросами из внешней системы по протоколам: REST, SOAP, XML-RPC. В результате разработки внешняя система сможет получить следующие данные:
1) Список всех достижений (в этом случае в запросе не указываются какие - либо дополнительные параметры).
2) Достижения определенного пользователя по идентификатору персоны из Электронного деканата.
3) Единичное достижение по идентификатору достижения.
4) Рейтинг пользователя по идентификатору персоны из Электронного деканата.
Пользовательский сценарий
1) Администратор СЭО 3КL создает веб - службу, включает внешние функции для получения информации по портфолио, выдает права пользователю, который будет обращаться к системе.
2) Для выполнения запросов в СЭО 3КL генерируется токен одним из способов:
— внешним запросом (из внешней системы выполняется запрос на получение токена, в запросе указываются: логин пользователя, пароль пользователя и сервис);
— через интерфейс СЭО 3КL (администратор СЭО 3КL на странице управления ключами выдает нужному пользователю токен).
1) Из внешней системы приходит запрос на получение данных по портфолио, используя полученный токен.
2) В ответ на полученный запрос СЭО 3КL отдает данные в соответствии с переданными параметрами.
3) Полученные данные используются во внешней системе.
Запросы на получение данных
Название | Функция | Парамеры запроса | Тип запроса | Ответ при успешном выполнении запроса |
Список достижений | block_dof_get_achievementins | id - необязательно, идентификатор достижения | GET | achievementins list of ( object { id achievementid personid moderatorid timecreated timechecked userpoints goaldeadline data status } ) } |
Достижения определенного пользователя по идентификатору персоны из Электронного деканата | block_dof_get_person_achievementins | id - обязательно, идентификатор персоны | GET | achievementins list of ( object { id achievementid personid moderatorid timecreated timechecked userpoints goaldeadline data status } ) } |
Рейтинг пользователя по идентификатору персоны из Электронного деканата | block_dof_get_person_rating | id - обязательно, идентификатор персоны | GET | object { personid, points } |