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

Получение результатов валидации телефонных номеров и отчетов о мошенничестве.

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

Получить все проверки телефонов с поддержкой пагинации.

Endpoint

GET /api/v1/checkers/phone/

Query параметры

Параметр	Тип	Обязательно	Описание
`page`	integer	Нет	Номер страницы
`page_size`	integer	Нет	Количество элементов на странице

Запрос

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/checkers/phone/?page=1&page_size=20' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ'

Ответ (200)

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "9adb5486-0742-4c6f-a372-d434649aa698",
      "status": "completed",
      "created_at": "2026-03-07T12:00:00Z",
      "report": {
        "mcc": "310",
        "mnc": "410",
        "VOIP": false,
        "city": "Washington",
        "name": "AT&T Mobility",
        "risky": false,
        "valid": true,
        "active": true,
        "leaked": false,
        "region": "District of Columbia",
        "carrier": "AT&T",
        "country": "United States",
        "message": "Действительный телефонный номер.",
        "prepaid": false,
        "spammer": false,
        "success": true,
        "timezone": "America/New_York",
        "zip_code": "20001",
        "formatted": "+1 202 555 0123",
        "line_type": "Mobile",
        "sms_email": "2025550123@txt.att.net",
        "request_id": "UuYUlmvcjn",
        "sms_domain": "txt.att.net",
        "do_not_call": false,
        "fraud_score": 15,
        "dialing_code": 1,
        "local_format": "(202) 555-0123",
        "recent_abuse": false,
        "active_status": "Active",
        "user_activity": "Medium",
        "accurate_country_code": true,
        "associated_email_addresses": {
          "emails": [],
          "status": "Связанные email не найдены."
        }
      }
    }
  ]
}

Получить конкретную проверку

Получить результаты для конкретной проверки телефона по ID.

Endpoint

GET /api/v1/checkers/phone/{id}/

Path параметры

Параметр	Тип	Обязательно	Описание
`id`	string (uuid)	Да	Идентификатор проверки

Запрос

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/checkers/phone/9adb5486-0742-4c6f-a372-d434649aa698/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ'

Ответ (200)

{
  "id": "9adb5486-0742-4c6f-a372-d434649aa698",
  "status": "completed",
  "created_at": "2025-02-17T00:00:00.394890Z",
  "report": {
    "mcc": "310",
    "mnc": "410",
    "VOIP": false,
    "city": "Washington",
    "name": "AT&T Mobility",
    "risky": false,
    "valid": true,
    "active": true,
    "leaked": false,
    "region": "District of Columbia",
    "carrier": "AT&T",
    "country": "United States",
    "message": "Действительный телефонный номер.",
    "prepaid": false,
    "spammer": false,
    "success": true,
    "timezone": "America/New_York",
    "zip_code": "20001",
    "formatted": "+1 202 555 0123",
    "line_type": "Mobile",
    "sms_email": "2025550123@txt.att.net",
    "request_id": "UuYUlmvcjn",
    "sms_domain": "txt.att.net",
    "do_not_call": false,
    "fraud_score": 15,
    "dialing_code": 1,
    "local_format": "(202) 555-0123",
    "recent_abuse": false,
    "active_status": "Active",
    "user_activity": "Medium",
    "accurate_country_code": true,
    "associated_email_addresses": {
      "emails": [],
      "status": "Связанные email не найдены."
    }
  }
}

Поля ответа

Поля верхнего уровня

Поле	Тип	Описание
`id`	string	Идентификатор проверки
`status`	string	Статус проверки (completed, processing, failed)
`created_at`	string	Временная метка создания проверки
`report`	object	Подробный отчет валидации

Поля отчета

Базовая информация

Поле	Тип	Описание
`valid`	boolean	Валиден ли телефонный номер
`active`	boolean	Активен ли номер в настоящее время
`success`	boolean	Успешна ли проверка
`message`	string	Сообщение о статусе
`formatted`	string	Международный формат
`local_format`	string	Локальный формат с учетом страны
`country`	string	Название страны
`dialing_code`	integer	Телефонный код страны

Информация об операторе

Поле	Тип	Описание
`carrier`	string	Название оператора
`name`	string	Полное название оператора
`line_type`	string	Тип (Mobile, Landline, VOIP, Unknown)
`mcc`	string	Mobile Country Code
`mnc`	string	Mobile Network Code
`prepaid`	boolean	Предоплаченный ли номер

Географическая информация

Поле	Тип	Описание
`city`	string	Название города
`region`	string	Штат/область
`zip_code`	string	Почтовый индекс
`timezone`	string	Идентификатор часового пояса IANA
`accurate_country_code`	boolean	Точно ли определена страна

Оценка мошенничества и рисков

Поле	Тип	Описание
`fraud_score`	integer	Оценка мошенничества (0-100, выше = рискованнее)
`risky`	boolean	Помечен ли номер как рискованный
`VOIP`	boolean	Является ли VOIP номером
`spammer`	boolean	Известный спамер
`leaked`	boolean	Найден в утечках данных
`recent_abuse`	boolean	Недавно использовался для злоупотреблений
`do_not_call`	boolean	В реестре "не звонить"
`user_activity`	string	Оценка уровня активности

Дополнительные возможности

Поле	Тип	Описание
`active_status`	string	Подробный статус активности
`sms_email`	string	Адрес шлюза SMS-to-email
`sms_domain`	string	Домен SMS шлюза оператора
`associated_email_addresses`	object	Связанные email адреса (если доступны)

Интерпретация оценки мошенничества

Диапазон	Уровень риска	Описание
0-25	Низкий риск	Номер выглядит легитимным
26-50	Средний риск	Присутствуют некоторые индикаторы риска
51-75	Высокий риск	Обнаружено несколько факторов риска
76-100	Очень высокий риск	Сильные индикаторы мошенничества

Пример недействительного номера

{
  "id": "f3b8c1a2-9d7e-4f6a-b5c8-1a2b3c4d5e6f",
  "status": "completed",
  "created_at": "2025-02-17T00:00:00.218312Z",
  "report": {
    "mcc": "N/A",
    "mnc": "N/A",
    "VOIP": null,
    "city": "N/A",
    "name": "N/A",
    "risky": null,
    "valid": false,
    "active": false,
    "leaked": false,
    "region": "N/A",
    "carrier": "N/A",
    "country": "N/A",
    "message": "Недействительный/несуществующий телефонный номер или указанная страна невозможна.",
    "prepaid": null,
    "spammer": false,
    "success": true,
    "timezone": "N/A",
    "zip_code": "N/A",
    "formatted": null,
    "line_type": "Unknown",
    "sms_email": "N/A",
    "request_id": "UuYUlmvcjn",
    "sms_domain": "N/A",
    "do_not_call": false,
    "fraud_score": 0,
    "dialing_code": 0,
    "local_format": null,
    "recent_abuse": null,
    "active_status": "N/A",
    "user_activity": "Требуется Enterprise L4+.",
    "accurate_country_code": false,
    "associated_email_addresses": {
      "emails": [],
      "status": "Связанные email не найдены."
    }
  }
}

Поля ответа

Поле	Тип	Описание
`id`	string (uuid)	Идентификатор проверки
`status`	string	Статус проверки
`created_at`	string (date-time)	Время создания
`report`	object	Отчет проверки

Поля отчета

Базовая информация

Поле	Тип	Описание
`valid`	boolean	Является ли номер телефона валидным
`active`	boolean	Активен ли номер в данный момент
`success`	boolean	Успешно ли выполнена проверка
`message`	string	Сообщение о результате
`formatted`	string	Международный формат номера
`local_format`	string	Локальный формат номера
`country`	string	Название страны
`dialing_code`	integer	Телефонный код страны

Информация об операторе

Поле	Тип	Описание
`carrier`	string	Название оператора
`name`	string	Полное название оператора
`line_type`	string	Тип линии (`Mobile`, `Landline`, `VOIP`, `Unknown`)
`mcc`	string	Mobile Country Code
`mnc`	string	Mobile Network Code
`prepaid`	boolean	Является ли номер предоплаченным

Географическая информация

Поле	Тип	Описание
`city`	string	Город
`region`	string	Регион/штат
`zip_code`	string	Почтовый индекс
`timezone`	string	Идентификатор часового пояса (IANA)
`accurate_country_code`	boolean	Точно ли определен код страны

Оценка мошенничества и рисков

Поле	Тип	Описание
`fraud_score`	integer	Оценка риска (0-100, выше = рискованнее)
`risky`	boolean	Помечен ли номер как рискованный
`VOIP`	boolean	Является ли номер VOIP
`spammer`	boolean	Известен ли номер как спамерский
`leaked`	boolean	Найден ли номер в утечках данных
`recent_abuse`	boolean	Зафиксированы ли недавние злоупотребления
`do_not_call`	boolean	Есть ли номер в реестре Do Not Call
`user_activity`	string	Оценка активности пользователя

Дополнительные возможности

Поле	Тип	Описание
`active_status`	string	Детальный статус активности
`sms_email`	string	Адрес SMS-to-email шлюза
`sms_domain`	string	Домен SMS-шлюза оператора
`associated_email_addresses`	object	Связанные email-адреса (если доступны)

Интерпретация оценки мошенничества

Диапазон	Уровень риска	Описание
0-25	Низкий	Номер выглядит легитимным
26-50	Средний	Есть отдельные риск-факторы
51-75	Высокий	Обнаружены множественные риск-факторы
76-100	Очень высокий	Сильные признаки мошенничества

Возможные статусы

Значение	Описание
`new`	Только создано, еще не обработано
`ready_to_perform_audit`	Готово к запуску проверки
`processing`	Идет формирование отчета
`completed`	Завершено (успех или ошибка, детали в `report`)

Примечания

Результаты проверки хранятся постоянно и могут быть получены несколько раз
Обработка обычно завершается за 1-3 секунды
Недействительные телефонные номера вернут valid: false с минимальными данными
Некоторые поля могут показывать "N/A" или null, если данные недоступны

Получить все проверки​

Endpoint​

Query параметры​

Запрос​

Ответ (200)​

Получить конкретную проверку​

Endpoint​

Path параметры​

Запрос​

Ответ (200)​

Поля ответа​

Поля верхнего уровня​

Поля отчета​

Базовая информация​

Информация об операторе​

Географическая информация​

Оценка мошенничества и рисков​

Дополнительные возможности​

Интерпретация оценки мошенничества​

Пример недействительного номера​

Поля ответа​

Поля отчета​

Базовая информация​

Информация об операторе​

Географическая информация​

Оценка мошенничества и рисков​

Дополнительные возможности​

Интерпретация оценки мошенничества​

Возможные статусы​

Примечания​

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

Endpoint

Query параметры

Запрос

Ответ (200)

Получить конкретную проверку

Endpoint

Path параметры

Запрос

Ответ (200)

Поля ответа

Поля верхнего уровня

Поля отчета

Базовая информация

Информация об операторе

Географическая информация

Оценка мошенничества и рисков

Дополнительные возможности

Интерпретация оценки мошенничества

Пример недействительного номера

Поля ответа

Поля отчета

Базовая информация

Информация об операторе

Географическая информация

Оценка мошенничества и рисков

Дополнительные возможности

Интерпретация оценки мошенничества

Возможные статусы

Примечания