Перейти к основному содержанию
GET
curl

Обзор

Возвращает постраничный список сущностей User для аутентифицированного приложения. Используйте его, чтобы синхронизировать пользователей с вашим хранилищем данных, находить пользователей, которым нужно внимание аналитика, или искать по отображаемому имени.

Когда использовать

  • Периодическая синхронизация таблицы пользователей с внешней BI-системой или хранилищем данных.
  • Очереди аналитиков: фильтруйте по status=FLAGGED или по устаревшему last_activity_at, чтобы формировать очередь на проверку.
  • Поиск пользователей по display_name, full_name или vendor_data.

Фильтры и пагинация

Примечания

  • Каждый элемент ответа содержит didit_internal_id. vendor_data может быть null, если исходная сессия или транзакция не передали это значение.
  • Этот endpoint использует пагинацию по курсору: сохраняйте курсор next между вызовами и прекращайте запросы, когда next пуст.
  • См. модель данных пользователя, где перечислены все поля записи пользователя.

Разрешения

Любой активный API-ключ приложения может вызывать этот endpoint. API-ключи Didit с областью действия на уровне приложения, а не роли: роли и разрешения в Консоли (list:users и остальные) определяют, что человек может делать в Консоли, и не применяются к трафику Management API. Чтобы ограничить доступ к этому endpoint, ограничьте круг лиц, которые могут читать API-ключ приложения.

Связанные материалы

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

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

limit
integer
по умолчанию:50

Размер страницы. По умолчанию 50, если не указан. Жёсткого максимума нет, но рекомендуется оставлять страницы небольшими для уменьшения задержки.

Требуемый диапазон: 1 <= x <= 1000000
offset
integer
по умолчанию:0

Смещение первой возвращаемой записи, начиная с нуля. Рекомендуется переходить по URL next с предыдущей страницы вместо вычисления вручную.

Требуемый диапазон: 0 <= x <= 1000000

Ответ

Список пользователей с пагинацией, со статусом верификации, количеством сессий и детализацией по функциям.

count
integer

Количество подходящих строк: точное до 100, с ограничением в 100 сверх этого для производительности. Не используйте его для определения последней страницы; вместо этого ориентируйтесь на то, что next равен null.

next
string | null

Абсолютный URL следующей страницы или null на последней странице.

previous
string | null

Абсолютный URL предыдущей страницы или null на первой странице.

results
object[]
Последнее изменение 7 ноября 2026 г.