Как настроить веб-сервисы
Веб-сервисы позволяют внешним системам (CRM, мобильные приложения, порталы) входить в YooLearn и выполнять операции через API. Инструкция предназначена для администраторов.
Предварительные условия
- Наличие прав администратора платформы.
- Понимание, какие операции должна выполнять внешняя система.
Основные шаги
- Включите веб-сервисы в Администрирование → Плагины → Веб-сервисы → Общие настройки.
- Включите нужный протокол (например, REST — см. Как использовать веб-сервис REST JSON).
- Создайте роль веб-сервиса и назначьте необходимые права.
- Создайте внешний сервис и добавьте в него нужные функции.
- Создайте токен для пользователя-интеграции.
- Передайте внешней системе адрес конечной точки и токен.
⚠️ Важно: токены веб-сервисов читаются один раз — после просмотра они становятся недоступны. Если забыли токен — создайте новый.
💡 Совет: для интеграций создавайте отдельного технического пользователя с минимальными правами (см. Аутентификация веб-сервисов).
Частые вопросы
- Проблема: Внешняя система не подключается. Решение: Проверьте, что веб-сервисы и протокол включены, сервис активен и токен корректен.
- Проблема: API возвращает ошибку прав. Решение: Добавьте нужные функции во внешний сервис и назначьте права роли веб-сервиса.
- Проблема: Потерян токен. Решение: Создайте новый токен в разделе «Веб-сервисы» → «Управление токенами».
Смотрите также
- Как использовать веб-сервис REST JSON
- Аутентификация веб-сервисов
- Как получить ключ безопасности (внешняя документация)