Skip to main content

Заголовки запроса

string
required
API токен сервисного пользователя в формате Bearer. Получите токен в панели администратора школы. Формат: Bearer YOUR_TOKEN.
string
required
Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами.
string
required
Уникальный идентификатор школы в системе. Определяет контекст выполнения операции.
Требуется аутентификация и право SchoolManageUsers.
Нужно найти сразу несколько пользователей — используйте Поиск списком идентификаторов.

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

Для поиска пользователя передайте один из ниже перечисленных параметров
Поиск осуществляется по логину (email/телефон/домен), затем по Telegram ID, затем по внешнему идентификатору extId. Приоритет: logintgIdextId. Если пользователь не найден — возвращается null. Если переданы несколько параметров — используется параметр с наивысшим приоритетом.
string
Логин пользователя. Может быть email адресом, номером телефона в международном формате или доменным логином (domain) — по умолчанию он имеет вид id12345, но может быть задан свой при создании/обновлении пользователя.
integer
Telegram ID пользователя. Целое число.
string
Внешний идентификатор пользователя из вашей системы.
Логином пользователя может быть:
  • Email адрес (например: [email protected])
  • Номер телефона в международном формате (например: +9876543210)
  • Домен пользователя (например, id12345)
Необходимо передать хотя бы один из параметров. Приоритет выбора: logintgIdextId. Если указаны все три — будет использован login.

Требования к правам доступа

Для поиска пользователя требуется право на управление пользователями школы.
Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной школе.
Поиск осуществляется только в рамках указанной школы. Пользователи из других школ не будут найдены.

Обновлено: 2026-08-05 14:14 UTC