Оценка риска номера телефона: Phone Risk API Didit

curl

curl -X POST https://verification.didit.me/v3/phone/risk/ \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone_number": "+14155552671",
    "country_code": "US",
    "vendor_data": "lead-123",
    "metadata": {"source": "signup_prescreen"}
  }'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.phone.assessRisk({
  phone_number: "+14155552671",
});
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Phone.AssessRisk(ctx, didit.PhoneRiskRequest{
	PhoneNumber: "+14155552671",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;
import me.didit.types.PhoneRiskRequest;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.phone().assessRisk(PhoneRiskRequest.builder()
        .phoneNumber("+14155552671")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->phone->assessRisk([
    'phone_number' => '+14155552671',
]);
print_r($result->toArray());

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Phone.AssessRiskAsync(new PhoneRiskRequest
{
    PhoneNumber = "+14155552671",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "request_id": "4fd09d2e-9bc9-4c4e-9c46-7f625ac0ab62",
  "status": "Approved",
  "phone": {
    "status": "Approved",
    "phone_number_prefix": "+1",
    "phone_number": "4155552671",
    "full_number": "+14155552671",
    "country_code": "US",
    "country_name": "United States",
    "carrier": {
      "name": "Example Mobile",
      "type": "mobile"
    },
    "is_disposable": false,
    "is_virtual": false,
    "verification_method": null,
    "verification_attempts": 0,
    "verified_at": null,
    "warnings": [],
    "lifecycle": [],
    "matches": [],
    "phone_intelligence": {
      "score": 3,
      "phone_type_risk": "Low",
      "phone_trust_index": 97,
      "network_stability_index": 95,
      "is_disposable": false,
      "is_ported": false,
      "is_recently_ported": false,
      "carrier_type": "mobile",
      "reason_codes": []
    },
    "enrichment": {
      "score": 3,
      "phone_type_risk": "Low",
      "phone_trust_index": 97,
      "network_stability_index": 95,
      "is_disposable": false,
      "is_ported": false,
      "is_recently_ported": false,
      "carrier_type": "mobile",
      "reason_codes": []
    }
  },
  "vendor_data": "lead-123",
  "metadata": {
    "source": "signup_prescreen"
  },
  "created_at": "2026-09-01T10:30:00.123456+00:00"
}

POST

phone

risk

curl

curl -X POST https://verification.didit.me/v3/phone/risk/ \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone_number": "+14155552671",
    "country_code": "US",
    "vendor_data": "lead-123",
    "metadata": {"source": "signup_prescreen"}
  }'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.phone.assessRisk({
  phone_number: "+14155552671",
});
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Phone.AssessRisk(ctx, didit.PhoneRiskRequest{
	PhoneNumber: "+14155552671",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;
import me.didit.types.PhoneRiskRequest;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.phone().assessRisk(PhoneRiskRequest.builder()
        .phoneNumber("+14155552671")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->phone->assessRisk([
    'phone_number' => '+14155552671',
]);
print_r($result->toArray());

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Phone.AssessRiskAsync(new PhoneRiskRequest
{
    PhoneNumber = "+14155552671",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "request_id": "4fd09d2e-9bc9-4c4e-9c46-7f625ac0ab62",
  "status": "Approved",
  "phone": {
    "status": "Approved",
    "phone_number_prefix": "+1",
    "phone_number": "4155552671",
    "full_number": "+14155552671",
    "country_code": "US",
    "country_name": "United States",
    "carrier": {
      "name": "Example Mobile",
      "type": "mobile"
    },
    "is_disposable": false,
    "is_virtual": false,
    "verification_method": null,
    "verification_attempts": 0,
    "verified_at": null,
    "warnings": [],
    "lifecycle": [],
    "matches": [],
    "phone_intelligence": {
      "score": 3,
      "phone_type_risk": "Low",
      "phone_trust_index": 97,
      "network_stability_index": 95,
      "is_disposable": false,
      "is_ported": false,
      "is_recently_ported": false,
      "carrier_type": "mobile",
      "reason_codes": []
    },
    "enrichment": {
      "score": 3,
      "phone_type_risk": "Low",
      "phone_trust_index": 97,
      "network_stability_index": 95,
      "is_disposable": false,
      "is_ported": false,
      "is_recently_ported": false,
      "carrier_type": "mobile",
      "reason_codes": []
    }
  },
  "vendor_data": "lead-123",
  "metadata": {
    "source": "signup_prescreen"
  },
  "created_at": "2026-09-01T10:30:00.123456+00:00"
}

Используйте POST /v3/phone/risk/, когда вам нужны аналитические данные о номере телефона перед, вместо или вне сценария с OTP. Он не отправляет код пользователю. endpoint создаёт API-сессию, обогащает данные номера, применяет ваши правила риска для телефонов и возвращает тот же нормализованный блок телефона, используемый в Проверке телефона, в одном синхронном ответе. Когда запрос сохраняется, Didit также может использовать номер телефона с рассчитанной оценкой в качестве совокупного свидетельства в Networks. Графы сетей могут показывать контекст, связанный с высокорисковыми аналитическими данными о телефоне, переносом номера и типом линии на общих телефонных сигналах, но они не раскрывают исходный номер телефона другим организациям.

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

status: окончательное решение для этой API-сессии. Обычно это Approved; оценка риска может дать In Review или Declined.
phone.full_number: нормализованный номер в формате E.164. phone.phone_number_prefix и phone.phone_number разделяют его на международный префикс и национальный номер.
phone.is_disposable и phone.is_virtual: стабильные сигналы «да/нет» для логики приложения. Поиск оператора добавляет carrier.name и carrier.type (mobile, voip и аналогичные).
phone.phone_intelligence.score использует шкалу риска от 0 до 100, где большее число означает более высокий риск. phone_type_risk (Low, Medium, High) и phone_trust_index (обратная величина оценки) представляют собой производные представления.
phone.phone_intelligence и phone.enrichment: псевдонимы совместимости с одним и тем же нормализованным объектом. Новые интеграции могут считывать phone.enrichment.
phone.matches перечисляет другие сессии вашего приложения, где тот же номер использовался другим пользователем. Используйте его для обнаружения дубликатов аккаунтов.
request_id: идентификатор API-сессии. Сохраняйте его вместе с vendor_data, если вам необходимо сопоставить результат с последующими событиями webhook или действиями в панели управления.

phone.phone_intelligence и phone.enrichment являются полями, заполняемыми по возможности. Завершённая проверка может опускать оба поля, если для этого номера, страны или тарифа не возвращено пригодных аналитических данных. Создавайте правила в первую очередь на основе стабильных нормализованных полей и расценивайте отсутствие аналитических данных как «неизвестно», а не как «безопасно».

Дополнение для цифрового следа

Установите enable_social в true, чтобы добавить блок phone_social в ответ внутри phone: онлайн-платформы, на которых зарегистрирован этот номер телефона, сгруппированные по категориям, со сводными количественными показателями и любыми сведениями профиля, возвращаемыми нашими поставщиками данных.

phone.phone_social.profiles_registered и phone.phone_social.profiles_checked являются ключевыми показателями: платформы, на которых подтверждена регистрация номера телефона, из числа проверенных платформ.
phone.phone_social.registered_platforms и phone.phone_social.not_registered_platforms перечисляют каждую платформу с её category и scope (global или local для региональных платформ).
phone.phone_social.categories содержит количество регистраций и соотношение по категориям, а phone.phone_social.profiles содержит сведения о профиле для конкретной платформы, если платформа их раскрывает (имя, URL фото, текст описания профиля, статус приватности, признак бизнес-аккаунта).
Сводные индексы (digital_footprint_diversity, digital_sophistication_index, engagement_depth_index, subscription_affordability_index) представляют собой составные показатели по шкале от 0 до 10. Любое значение счётчика может быть null, если проверка не вернула по нему данных.

profiles_registered: 0 представляет собой реальный ответ, а не сбой: платформы были проверены, и номер телефона не был найден ни на одной из них, что является типичным признаком синтетической личности. Этот endpoint не предпринимает действий на его основе самостоятельно; используйте phone_no_social_presence_action в сценарии, чтобы преобразовать его в вердикт Review или Decline. Блок отсутствует, если enable_social не задан, а также в случаях, когда проверку соцсетей не удалось завершить, и в этом случае плата за неё не взимается.

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

Ключи песочницы проверяют запрос и возвращают детерминированные данные со статусом одобрения. Они не отправляют OTP, не расходуют кредиты, не создают сессию и не добавляют данные в Networks. При установленном enable_social они также возвращают детерминированный блок phone_social.

Биллинг

Вызовы Phone Risk API стоят $0.04 по цене из тарифной таблицы, то есть дешевле, чем полная Проверка телефона, поскольку OTP не отправляется. Запрос в продакшн-среде подлежит оплате с момента начала поиска, даже если некоторые поля, заполняемые по возможности, недоступны. Дополнение для цифрового следа тарифицируется отдельно: одна единица phone_social за запрос сверх стоимости Phone Risk 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.

Тело

application/json

phone_number

string

обязательно

Номер телефона для скоринга. Проходит валидацию и нормализуется до формата E.164.

Maximum string length: 20

Пример:

"+14155552671"

country_code

string

Необязательная подсказка страны ISO 3166-1 alpha-2 или alpha-3 для аналитического покрытия.

Maximum string length: 3

Пример:

"US"

signals

object

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

Show child attributes

vendor_data

string

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

metadata

object | null

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

Если true, также запрашивает цифровой след номера: мессенджеры, социальные сети, площадки электронной коммерции и профессиональные платформы, где он зарегистрирован. Тарифицируется как одна единица phone_social за запрос дополнительно к цене самого endpoint.

Пример:

true

Ответ

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

request_id

string<uuid>

обязательно

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

status

enum<string>

обязательно

Окончательное решение для этой сессии API. Обычно Approved; оценка риска может дать In Review или Declined.

Доступные опции:

Approved,

In Review,

Declined

created_at

string<date-time>

обязательно

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

vendor_data

string | null

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

metadata

object | null

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

phone

object

Нормализованный отчёт по телефону, аналогичный блоку, используемому в ответах Проверки телефона.

Show child attributes

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

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

​Дополнение для цифрового следа

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

​Биллинг

Авторизации

Тело

Ответ

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

Дополнение для цифрового следа

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

Биллинг