Перейти к основному содержанию
POST
Python
API поиска пользователей Didit за один вызов сопоставляет список, содержащий до 20 000 идентификаторов, с пользователями вашего приложения и сообщает, какие идентификаторы не совпали ни с одним пользователем. Используйте его, если у вас есть список аккаунтов, например, получатели пакета выплат, аккаунты партнёра или результаты запроса по мошенничеству, и вам нужен статус верификации каждого из них.

Как это работает

  1. Выполните поиск. Вызовите POST /v3/users/lookup/ с вашими идентификаторами. Вызов только читает данные и возвращает lookup_id, количества и идентификаторы, которые не совпали ни с одним пользователем.
  2. Получите пользователей. Передайте lookup_id как lookup в вызове Список пользователей. Он возвращает только совпавших пользователей, в том порядке, в котором вы передали идентификаторы.

Правила сопоставления

Каждый идентификатор сопоставляется внутри вашего приложения в следующем порядке:
  • Пустые записи удаляются, а из дубликатов сохраняется первая запись.
  • Один запрос содержит не более 100,000 записей. После удаления пустых записей и дубликатов должно остаться от 1 до 20,000 идентификаторов. Превышение любого из лимитов возвращает 400 с code: too_many_identifiers.
  • Поиск выполняется только по вашему приложению.

Запрос

Ответ

Получение найденных пользователей

  • Пользователи возвращаются в порядке их идентификаторов в вашем списке, с постраничным выводом через limit и offset. Если один адрес электронной почты совпадает с несколькими пользователями, они перечисляются от самой старой учётной записи к самой новой.
  • Результат хранится 24 часа и доступен только вашему приложению. По истечении этого срока lookup возвращает 404 с code: lookup_not_found: отправьте список повторно.

Повторное получение результата поиска

GET /v3/users/lookup/{lookup_id}/ возвращает то же тело, что и поиск, а также identifiers: список, который вы отправили, после удаления пустых значений и дубликатов, в исходном порядке. Если поиск истёк, не существует или принадлежит другому приложению, эндпоинт отвечает 404 с code: lookup_not_found.

Ошибки

Разрешения

Для API-ключа нужен доступ на чтение пользователей, а endpoint никогда не изменяет данные. Ключ без этого доступа или отозванный ключ получает 403. Области доступа ключа задаются для каждого ключа в разделе API-ключи. Роли и разрешения в Консоли определяют, что может делать конкретный человек в Консоли, и для трафика API не проверяются. В Консоли для поиска в списке достаточно разрешения на чтение пользователей.

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

Авторизации

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

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Тело

application/json
identifiers
string[]
обязательно

Each entry is a vendor_data value, a Didit user ID or a verified email. Send at most 100,000 entries. Blank entries are dropped and duplicates removed, keeping the first, and at most 20,000 identifiers must remain. Either limit exceeded is a 400 with code: too_many_identifiers, and an empty list is a 400 too.

Maximum array length: 100000
Пример:

Ответ

The lookup was read. Use lookup_id with List users.

lookup_id
string<uuid>
обязательно

Pass it as lookup to List users.

requested
integer
обязательно

Identifiers read, after blanks and duplicates were removed.

found
integer
обязательно

Identifiers that matched at least one user.

not_found
object[]
обязательно
expires_at
string<date-time>
обязательно

When the result expires (24 hours after the lookup).

Последнее изменение 20 ноября 2026 г.