Перейти к основному содержанию
POST
curl
Используйте POST /v3/ip/risk/, когда ваш бэкенд уже располагает IP-адресом и ему нужно получить решение о риске для взаимодействия между серверами. Ответ включает геолокацию, данные о владельце сети, флаги VPN/Tor и центров обработки данных, данные об угрозах, а также country_mismatch, если вы передаёте заявленную страну.

Интерпретация ответа

  • status принимает значение In Review, если страна, определённая по адресу, не совпадает с claimed_country, или если адрес связан с инфраструктурой VPN, Tor или центра обработки данных. В остальных случаях значение Approved.
  • ip.ip_country_code содержит код страны, определённый по адресу. Для сравнения стран используйте ip.country_mismatch, а не сравнивайте строки с названиями стран самостоятельно.
  • ip.latitude и ip.longitude содержат приблизительную геолокацию сети, а не точное местоположение устройства.
  • ip.is_vpn_or_tor, ip.is_data_center, ip.proxy_type и ip.threat содержат признаки сетевого риска.
  • ip.asn_number, ip.asn_organization, ip.connection_type и ip.carrier описывают сеть, к которой принадлежит адрес.
  • request_id является идентификатором API-сессии. Сохраняйте его вместе с vendor_data, если нужно связать результат с последующими webhook-событиями или активностью в консоли.
Обогащение данных по IP выполняется по возможности. Если ни один источник обогащения не возвращает пригодных данных, endpoint возвращает одобренный ответ с ip.ip_address: null, ip.country_mismatch: null и пустым объектом ip.threat. Отдельные поля обогащения также могут быть null, если данные недоступны.

Анализ устройства

IP Risk API является исключительно серверным endpoint для взаимодействия между серверами. Фингерпринтинг устройства он не выполняет, поскольку бэкенд сам по себе не может наблюдать сигналы браузера или устройства. Для сессий в размещённом сценарии и в SDK Didit предоставляет уже собранные данные об устройстве в ответе сессии, включая device_fingerprint, сведения об устройстве и браузере, user_agent, необработанные данные об устройстве и совпадения между сессиями.

Поведение в песочнице

Ключи песочницы проверяют запрос и возвращают детерминированные одобренные данные. Они не обращаются к внешним сервисам анализа данных, не списывают кредиты, не создают сессию и не вносят вклад в Networks.

Биллинг

Вызов IP Risk API стоит $0.02 по прайс-листу. Запрос в боевом режиме тарифицируется с момента начала поиска.

Авторизации

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.

Тело

application/json
ip_address
string<ip>
обязательно

Адрес IPv4 или IPv6 для оценки.

Пример:

"8.8.8.8"

claimed_country
string

Необязательный код страны ISO 3166-1 alpha-2 или alpha-3, заявленный пользователем или сессией. Используется для вычисления country_mismatch.

Maximum string length: 3
Пример:

"ESP"

user_agent
string

User-Agent, зафиксированный вашим бэкендом. Сохраняется как контекст запроса; не обеспечивает фингерпринтинг устройства.

Maximum string length: 512
vendor_data
string

Ваш постоянный идентификатор для этого запроса. Сохраняется в API-сессии и возвращается в ответе.

metadata
object | null

Ваши неконфиденциальные метаданные JSON. Сохраняются в сессии API и возвращаются в ответе.

Ответ

Оценка риска завершена. Проверьте status для получения решения; для завершённых запросов HTTP-код всегда 200.

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

Идентификатор API-сессии, созданной для этого запроса. Сохраняйте его вместе с vendor_data, если нужно сопоставлять результат с последующими событиями webhook или действиями в консоли.

status
enum<string>
обязательно

Решение для этой API-сессии: In Review при риске сети или несовпадении стран, иначе Approved.

Доступные опции:
Approved,
In Review
created_at
string<date-time>
обязательно

Временная метка этого ответа.

vendor_data
string | null

Эхо-значение переданного вами vendor_data, либо null, если вы его не передавали.

metadata
object | null

Эхо-значение переданного вами metadata, либо null, если вы его не передавали.

ip
object

Результат оценки риска IP-адреса. Отдельные поля обогащения данных могут иметь значение null, если при поиске не было получено пригодных данных.

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