Перейти к основному содержанию
POST
Python
Отправляйте введённые вручную идентификаторы и заявленные атрибуты личности, выбирайте проверки для запуска и изучайте результат каждой отдельно. Сначала воспользуйтесь Планированием проверки на мошенничество, чтобы уточнить требования к входным данным и ожидаемую стоимость.

Выбор профиля

Закрепите profile_version, чтобы выбранные значения по умолчанию и политика принятия решений были явными. Профиль по умолчанию: standard, версия 2026-08-27. Версия 2026-09-14 добавляет необязательное социальное обогащение данных по email и телефону и фиксирует каждую завершённую проверку как нативную сессию Проверки пользователей. В этой версии платные дополнения подключаются только по явному выбору. Версия 2026-09-14.1 также включает поиск по идентификаторам в глобальной сети мошенничества для организаций на тарифе Enterprise, которые участвуют в глобальном обмене данными. Версия 2026-09-14.2 добавляет необязательную проверку соответствия селфи и CPF для Бразилии. Более ранние версии сохраняют исходное поведение. Текущие профили поддерживают проверку риска по email, телефону и IP, проверку по базам данных там, где она доступна, и историю по приватной сети вашего приложения. Биометрическая привязка по селфи требует версии 2026-09-14.2. При выборе этой версии в более ранних версиях возвращается not_available_in_profile_version.

Заявленная личность и контекст

Передавайте email, телефон и государственные идентификаторы в subject.identifiers. Для государственных идентификаторов необходимо указать страну выдачи; в регионах, где номера уникальны только в пределах региона, может потребоваться и орган выдачи. Имена, дату рождения, гражданство и адрес передавайте в subject.attributes. Это заявления, которые сверяются с данными выбранного источника, если он их поддерживает, а не проверенные факты только потому, что они были переданы. Используйте context для IP-адреса попытки, пользовательского агента, цели, страны и любого обязательного подтверждения согласия. Так информация о попытке верификации отделяется от информации о человеке. Для поддерживаемых биометрических проверок передавайте subject.selfie как JPEG, PNG или WebP в кодировке base64, размером до 6 МБ. Также принимается соответствующий URI данных изображения. Не отправляйте эталонное изображение, удалённый URL или ключ хранилища.

Селфи и заявленный идентификатор

Выберите biometric_identity, передайте бразильский идентификатор tax_number и селфи и подтвердите context.consent_obtained. Проверка определяет, принадлежит ли это селфи заявленному владельцу CPF. При отсутствии согласия возвращается consent_required, а для неподдерживаемых стран unsupported_region. Модуль имеет цену за проверку, основанную на ставке проверки по базам данных вашей организации; перед запуском проверьте тариф. Когда проверка возвращает ответ, identity_relationship.result принимает значение match, mismatch или inconclusive. Неокончательный ответ требует ручной проверки и никогда не трактуется как несовпадение. Результат лишь устанавливает связь между селфи и CPF. Он не подтверждает переданные имя или дату рождения, не доказывает живость и не выполняет поиск лица в интернете или в глобальной сети мошенничества. Имена и дата рождения остаются заявлениями, если только другой выбранный источник не предоставляет доказательства для этих полей. Тайм-ауты и ошибки источников являются недоступными результатами и не тарифицируются. Завершённые неокончательные ответы тарифицируются по той же ставке за проверку. Селфи не включается в результат и не сохраняется этой проверкой в качестве медиафайла сессии.

Выбор проверок

checks.include выбирает модули, а checks.exclude имеет приоритет. Явно пустой список include отключает все необязательные операции; нормализация при этом выполняется. Если include не указан, используются значения по умолчанию закреплённого профиля. Социальное обогащение по email и телефону выбирается отдельно через email_social и phone_social. Для них требуется корректный идентификатор, соответствующий переданным данным, и оно не отправляет OTP-код.

Чтение результатов без их смешения

Каждый модуль сообщает свой статус выполнения, причину и тарифицируемые единицы. not_requested, excluded_by_caller, missing_required_input и source_unavailable описывают разные исходы. Отсутствие источника не означает несовпадения личности и не является результатом с нулевым риском. attribute_evidence описывает доказательства на уровне полей, а risk отдельно учитывает аспекты личности, контакта, устройства, поведения и сети мошенничества. Общий email, устройство или другой идентификатор является наблюдаемой связью, а не доказательством того, что два аккаунта принадлежат одному человеку или что владельцы этих аккаунтов совершили мошенничество. recommendation является рекомендацией проверки; она не меняет статус другой записи. Результаты социального обогащения выводятся в enrichment, при этом недоступные результаты отделены от завершённых.

Глобальная сеть мошенничества

Выберите networks_cross_org, чтобы проверять поддерживаемые адреса электронной почты, номера телефонов и идентификаторы документов с корректно указанными пространствами имён по общей сети. Для этого поиска нужен тариф Enterprise и режим обмена данными вашей организации global. Без них тариф возвращает модуль с available: false и availability_reason: "entitlement_required", а проверка, которая выбирает этот модуль, пропускает его со статусом skipped и причиной entitlement_required. Та же причина применяется, если Networks не включен для вашей организации. Песочница не ограничивается тарифом или режимом обмена данными: при поддерживаемом идентификаторе модуль выполняется и возвращает пустой пример результата. Поиск использует существующий бюджет чтения организации и записывает в аудит факт чтения. За каждый поиск отдельной оплаты нет. Планирование проверки не запрашивает общий индекс и не расходует его бюджет чтения. network.cross_organization содержит signals_checked и раскрытые агрегированные insights после завершения проверки. Каждый инсайт содержит тип сигнала, классы исходов, количество источников, предоставивших данные, временной интервал давности и отраслевые категории, но только если раскрытие включено. Он никогда не указывает на другую организацию, аккаунт, человека или верификацию. Результаты ниже порога раскрытия не показываются; пустой список не доказывает отсутствие истории мошенничества. Раскрытый общий сигнал приводит к рекомендации проверки, но никогда не ведет к автоматическому отклонению или к признанию совпадения личности. Недоступный поиск сообщает свою причину отдельно от пустого завершенного поиска. Если ваша организация позже теряет доступ к межорганизационной сети, например после смены тарифа или когда режим обмена данными перестает быть global, получение результатов, повторные попытки и данные сессии скрывают общие агрегаты и производные данные о риске, основанные на них. Исходная рекомендация остается историческим решением; чтение не меняет статус верификации.

Сессии, повторные попытки и списания

check_id получает сохраненный результат через Get a Fraud Check. Если request_id присутствует, он указывает на нативную сессию верификации этой проверки. Версии 2026-09-14, 2026-09-14.1 и 2026-09-14.2 всегда создают эту сессию, в том числе когда выбрана только история частной сети. Повторное использование client_reference с тем же телом запроса возвращает исходный результат без повторного выполнения и без списания, пока эта проверка существует. Другое тело запроса с тем же референсом возвращает 409. Если выполнение еще идет, повторите тот же запрос после интервала из заголовка ответа Retry-After. Удаление связанной верификации также удаляет результат Fraud Check; после этого получение возвращает 404. Проверка, удаленная во время выполнения, не может опубликовать завершенный результат. Цены берутся из текущих предоплаченных или контрактных тарифов вашей организации. Недоступные и пропущенные модули не тарифицируются, а история частной сети не имеет отдельной оплаты за проверку. Проверки в песочнице используют тестовые ответы без обращений к платным поставщикам и без списаний.

Авторизации

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.

Тело

subject
object
обязательно
client_reference
string

Ваш собственный идентификатор этой проверки. Также служит ключом идемпотентности: повторное использование с тем же телом запроса возвращает исходную проверку без повторного запуска или списания средств за модули; повторное использование с другим телом запроса возвращает 409.

Required string length: 1 - 255
profile
string
по умолчанию:standard

Идентификатор профиля оркестрации. По умолчанию используется профиль Didit standard.

Required string length: 1 - 64
profile_version
string

Закрепить зафиксированную версию профиля. По умолчанию используется текущая версия профиля.

Required string length: 1 - 32
context
object
checks
object
vendor_data
string
Maximum string length: 1000
metadata
any

Ответ

check_id
string<uuid>
обязательно
client_reference
string | null
обязательно
processing_status
enum<string>
обязательно
  • pending - В ожидании
  • running - Выполняется
  • completed - Завершено
  • failed - Не выполнено
Доступные опции:
pending,
running,
completed,
failed
profile_id
string
обязательно
profile_version
string
обязательно
created_at
string<date-time>
обязательно
completed_at
string<date-time> | null
обязательно
inputs
object[]
обязательно
modules
object[]
обязательно
attribute_evidence
object[]
обязательно
compound_evidence
object[]
обязательно
risk
object[]
обязательно
network
object
обязательно
recommendation
enum<string>
обязательно
  • approve - Одобрить
  • review - На проверку
  • reject - Отклонить
Доступные опции:
approve,
review,
reject
next_action
enum<string>
обязательно
  • none - Нет
  • manual_review - Ручная проверка
  • step_up - Дополнительная проверка
  • resubmit_capture - Повторная отправка снимка
Доступные опции:
none,
manual_review,
step_up,
resubmit_capture
decision_reasons
string[]
обязательно
coverage
object
обязательно
usage
object[]
обязательно
request_id
string<uuid>

Нативная сессия верификации, созданная для этой проверки.

enrichment
object
identity_relationship
object | null
vendor_data
string | null
metadata
unknown
Последнее изменение 7 ноября 2026 г.