1) адрес API. Адрес контура: https://vitrinadiagnostik.ru/api;
2) формат запросов и ответов API. Работа с API происходит в формате JSON;
3) подпись запросов. Поставщик получает client_id и client_secret внутри платформы. Подпись это jwt-токен, внутри которого находится client_id, а также exp -- время истечения токена, подписанный с помощью client_secret. Параметр exp передается в формате целого числа (timestamp), время учитывается в utc таймзоне. Параметр exp должен иметь значение не более чем на час в будущее и не менее чем на полчаса в прошлое от времени сервера. Поддерживается алгоритм шифрования jwt-токена HS256. Сформированный jwt-токен кладется в заголовок Authorization: Bearer <токен>.
Возможные ошибки:
¦ ошибка авторизации (неподписанный запрос);
¦ ошибка истечения срока действия токена;
¦ ошибка слишком большого срока действия токена;
¦ ошибка неуказанного истечения срока действия токена;
¦ ошибка неверной подписи;
¦ ошибка несуществующего clientjd;
4) Взаимодействие с API. Витрина для идентификации пользователя на стороне поставщика добавляет к адресу диагностики гет-параметр ran_token, по которому поставщик может:
¦ запросить у витрины персональные данные по пользователю, прошедшему диагностику;
¦ отправить на витрину результаты прохождения диагностики;
¦ отправить на платформу перечень рекомендованных образовательных программ;
5) запрос поставщиком у витрины персональных данных пользователя. Адрес метода -- /api/diagnostics.user_info. Принимаемые параметры: ran_token -- string. Возвращаемый ответ: «patronymic»: «Иванович», «id»: 10, «first_name»: «Геннадий», «birthday»: «2000-10-10», «last_name»: «Афанасьев».
Полный перечень параметров является расширяемым по мере подключения поставщиков диагностик;
6) отправка поставщиком на витрину результатов диагностики пользователя. Адрес метода -- /api/diagnostics.process_results. Принимаемые параметры:
¦ ran_token -- string -- токен прохождения;
¦ result (необязательный) -- float -- результат диагностики в процентах от 0 до 100;
¦ results (необязательный) -- результаты диагностики по каждой компетенции в следующем формате: “results”: {“competence_key1”: 34.5; “competence_key2”: 80; },
где competence_key1 и competence_key2 -- ключи компетенций, указанные при подаче заявки, значения также должны быть от 0 до 100. Если у диагностики указаны авторские компетенции, то обязательно отправляется results, если не указаны -- то result.
В случае использования параметра results, результат должен быть предоставлен по каждой из компетенций.
Возвращаемые параметры: status -- результат записи:
¦ ОК (все хорошо);
¦ Ошибка: Не найдена компетенция (относится к результатам);
¦ Ошибка: Не найдено прохождение (определяется по ran_token -- ключ прохождения). Помимо результатов принимаются: текстовое поле (string) с описанием полученных результатов; рекомендации в виде id образовательных программ (числовое значение) и описаний к ним (string). Таким образом, после каждого прохождения независимой оценки компетенций ЦЭ возвращается результат, содержащий процент владения тестируемым компетенцией или компетенциями (в случае, если диагностика привязана к нескольким авторским компетенциям одновременно) и перечень рекомендуемых образовательных программ.
На пятом уровне модели независимой оценки компетенций ЦЭ определяются направления потенциальной интеграции витрины как со смежными платформами, реализуемыми в рамках федерального проекта «Кадры для цифровой экономики», так и с другими актуальными интернет-ресурсами, базовыми из которых являются:
1) поддержка альтернативных способов авторизации;
2) механизм интеграции с базовой моделью компетенций Университета 20.35 в режиме загрузки справочника и/или в режиме регулярной онлайн синхронизации;
3) программный интерфейс для организации подключения внешних сервисов оценки компетенций;
4) выгрузка результатов тестирования для использования работодателями и соискателями;
5) возможность выгрузки результатов тестирования в информационные системы, отслеживающие цифровой след1.
В части поддержки альтернативных способов авторизации базово реализуются:
¦ возможности первичной аутентификации через ЕСИА См. например, Стандарт цифрового следа [Electronic resource]. URL: https://standard.2035. university (дата обращения: 20.03.2020). Единая система идентификации и аутентификации -- информационная система в Российской Федерации, обеспечивающая санкционированный доступ участников информационного взаимодействия к информации, содержащейся в государственных информационных системах и иных информационных системах, https://esia.gosuslugi.ru.;
¦ возможность первичной аутентификации в системе аутентификации Leader-ID 1еас1ег-Ю -- информационная система поддержки лидеров, система разнообразных «социальных лифтов», позволяющих достигать нового уровня карьерного, профессионального, личностного и социального развития, https://leaCer-iC.ru.;
¦ возможности первичной аутентификации через социальные сети.
Пройти тестирование или войти в реестр аккредитованных поставщиков диагностик на витрине независимой оценки компетенций ЦЭ можно по адресу https:// vitrinadiagnostik.ru (рис.):
Литература
1. Данилюк А. Я., Кондаков А. М. Концепция Базовой модели компетенций цифровой экономики. Москва: РУДН, 2018.
2. Солдатова Г. У., Зотова Е., Лебешева М., Шляпников В. Интернет: возможности, компетенции, безопасность : Методическое пособие для работников системы общего образования. М. : Google, 2013.
3. Boyatzis R. E. The competent manager: a model for effective performance. New York : Wiley, 1982.
4. Brophy M., Kiely T. Competencies: a new sector, Journal of European Industrial Training. 2002. Vol. 26, N 2, 3-4. P. 165-176.
5. McClelland D. C. Testing for Competence Rather Than for «Intelligence». 1973 [Electronic resource]. URL: https://www.therapiebreve.be/documents/mcclelland-1973.pdf (accessed: 06.03.2020).
6. Garavan T. N., McGuire D. Competencies and workplace learning: some reflections on the rhetoric and the reality, Journal of Workplace learning. 2001. Vol. 13, N 3-4. P. 144-163.
7. Heffernan F., Flood P. An exploration of the relationships between the adoption of managerial competencies, organisational characteristics, human resource sophistication and performance in Irish organisations, Journal of European Industrial Training. 2000. Vol. 24. N 2-4. P. 128-136.
8. MaalekiA. The ARZESH Competency Model, Appraisal and Development Manager's Competency Model. Lambert Academic Publishing. 2018.
9. Rankin N. Raising performance through people: The ninth competency survey. Competency and Emotional Intelligence. January, 2002. Vol. 2. N 21.
10. Stuart R., Lindsay P. Beyond the frame of management competencies: towards a contextually embedded framework of managerial competence in organizations. Journal of European Industrial Training. Vol. 21, N 1. P. 26-33.
11. Viitala R. Perceived development needs of managers compared to an integrated management competency model, Journal of Workplace Learning. 2005. Vol. 17, N 7. P. 436-451.
12. White R. W. Motivation reconsidered: The concept of competence. Psychological Review. 1959. Vol. 66, N 5. P. 297-333.
13. Wickramasinghe V., De Zoyza N. Gender, age and marital status as predictors of managerial competency needs: Empirical evidence from a Sri Lankan telecommunication service provider. Gender in Management: An International Journal. 2008. Vol. 23, N 5. P. 337-354.