> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Проверка телефона API: SMS OTP и риск-сигналы

> Didit: SMS OTP в два шага с проверкой оператора, виртуальных и одноразовых номеров. Оплата за использование: тариф оператора + $0.02, без контрактов.

Phone Verification API предоставляет двухэтапный процесс: отправка одноразового кода на номер телефона и последующая проверка этого кода. Система определяет тип оператора, виртуальные и одноразовые номера.

## Эндпоинты

> [card] [Отправка кода на телефон](https://docs.didit.me/ru/standalone-apis/phone-send.md)
>
> `POST /v3/phone/send/` — Отправка одноразового кода подтверждения по SMS.

> [card] [Проверка кода телефона](https://docs.didit.me/ru/standalone-apis/phone-check.md)
>
> `POST /v3/phone/check/` — Проверка кода и получение данных о рисках, связанных с номером телефона.

> [card] [Оценка риска телефона](https://docs.didit.me/ru/standalone-apis/phone-risk.md)
>
> `POST /v3/phone/risk/` — Оценка оператора, типа линии, переноса номера и риска мошенничества без отправки OTP.

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

1. Вызовите **Отправку кода на телефон**, передав номер телефона в формате E.164 (например, `+14155552671`)
2. Пользователь получает код по SMS (действителен 5 минут)
3. Вызовите **Проверку кода телефона**, передав номер телефона и код
4. Получите результат проверки и сигналы риска (тип оператора, определение виртуального номера)

## Каналы доставки

Didit поддерживает несколько каналов в зависимости от доступности в стране:

| Канал | Описание |
| - | - |
| SMS | Стандартное текстовое сообщение |
| WhatsApp | Сообщения в WhatsApp |
| Telegram | Сообщения в Telegram |
| RCS | Сервисы расширенных сообщений |
| Viber | Сообщения в Viber |

## Сигналы риска

| Сигнал | Описание |
| - | - |
| `is_disposable` | Временный или одноразовый номер телефона |
| `is_virtual` | VoIP или виртуальный номер |
| `carrier.type` | `mobile`, `landline` или `voip` |

Полную структуру ответа см. в [Отчёт о проверке телефона](https://docs.didit.me/ru/core-technology/phone-verification/overview.md).

## Сбои у провайдера

Если провайдер телефонии не отвечает на запрос отправки или проверки, оба эндпоинта возвращают `502` с `code: "phone_provider_unavailable"` вместо общей ошибки. Повторный запрос в этом случае безопасен, не тарифицируется и не расходует попытку из почасового лимита на номер. Ориентируйтесь на `code`, а не разбирайте текст `detail`: формулировка сообщения не является стабильным контрактом.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.