Заголовки запроса
string
обязательно
API-токен сервисного пользователя в формате
Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете:
Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».integer
обязательно
Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в
карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
integer
обязательно
Числовой ID школы, берётся там же, где
Seller-Id. Значение должно совпадать со школой продавца — иначе
вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".SchoolManageUsers).
Параметры запроса
Передайте хотя бы один из списков идентификаторов
Метод возвращает массив найденных пользователей. Пользователи, которых не удалось найти, в ответ не включаются —
сопоставляйте результат с запросом по
email/phone/domain/tgId/extId на своей стороне. Если передано
несколько списков, условия объединяются через «ИЛИ»: в ответ попадает пользователь, совпавший хотя бы с одним
значением из любого списка, — каждый пользователь не более одного раза. Порядок элементов в ответе не
соответствует порядку в запросе.string[]
Список логинов пользователей: email, телефон в международном формате или доменный логин (
domain, например
i_ivanov; значение вида id12345 ищет пользователя с ID 12345). От 2 до 50 символов каждый, максимум
250 элементов.integer[]
Список Telegram ID пользователей. Максимум 250 элементов.
string[]
Список внешних идентификаторов из вашей системы. От 1 до 50 символов каждый, максимум 250 элементов.
Требования к правам доступа
Для поиска пользователей требуется право «Управление пользователями школы» (
SchoolManageUsers).Обновлено: 2026-09-25 13:43 UTC