Идентичность и верификация 2 Конечные точки 7 Ключевые возможности

API для Аналитика телефонных номеров

Проверяйте национальные и международные телефонные номера, нормализуйте их формат и добавляйте полезный офлайн-контекст. Результаты могут содержать местоположение по плану нумерации, возможные часовые пояса, первоначального оператора префикса, правила набора, признаки короткого номера и соответствующие публичные распределения регуляторов без платного телекоммуникационного поиска.

Category Идентичность и верификация
Конечные точки 2
Ключевые возможности 7
Заголовок 5

Используется сотрудниками известных компаний

VercelLLM PulseOLXCasa ModernaPipeCal.comBeehiivSnykTogglRemoteSprigDeel

Сигналы доверия перед интеграцией

Прозрачная документация, аутентифицированные запросы и видимые сведения о надежности помогают оценить DomScan перед запуском.

Работает Статус сервиса

Перед интеграцией проверьте состояние сервиса в реальном времени и документированные ответы при сбоях.

OpenAPI API-артефакты

OpenAPI, Swagger, Postman, CLI, SDK и ссылки MCP доступны в один клик.

API-ключи Защищенный доступ

Аутентифицированные эндпоинты используют API-ключи с понятной стоимостью в кредитах до вызова.

10,000 Бесплатный лимит

Начните с 10 000 кредитов в месяц и обновляйтесь только при росте использования.

Что помогает запустить эта API

Используйте эту страницу как производственный бриф: конечные точки, примеры, форма ответа и элементы workflow для подключения DomScan к вашему продукту.

Продуктовые workflow

Встраивайте проверки доменов, DNS-интеллект, сигналы риска или обогащение в онбординг, поиск и внутренние инструменты.

Автоматизация аналитиков

Заменяйте повторяющиеся ручные проверки расписаниями, оповещениями и воспроизводимыми шагами расследования.

Чистые JSON-данные

Используйте предсказуемые поля, документированные коды состояния и стоимость в кредитах вместо scraping страниц провайдеров.

AI и ops-инструменты

Передавайте данные агентам, дашбордам, SOAR-плейбукам и CRM через OpenAPI, SDK, Postman или MCP.

Интеграционный workflow

Простой путь от первого запроса до повторяемого использования в продакшене.

1
Аутентифицируйтесь один раз

Передавайте API-ключ в документированном заголовке и сохраняйте единый формат запросов между сервисами.

2
Запрашивайте по примерам

Начните с примеров curl и HTTP, затем перенесите параметры в код приложения.

3
Эксплуатируйте и мониторьте

Используйте коды состояния, стоимость кредитов и поля ответа для retries, логов и alerts.

Набор разработчика

Переходите к машиночитаемой документации, коллекциям запросов, SDK или инструментам для агентов.

Карта параметров и ответа

Просмотрите входы, поля ответа и коды состояния перед подключением endpoint к клиенту.

Параметры запроса

Параметр

phonedefault_countryexpected_countrydialing_from_countrylanguagephones
Поля ответа

Пример ответа

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164
Покрытие статусов

Коды статуса HTTP

200400401402429500

Конечные точки

POST /v1/phone/validate
Кредиты: 1Аутентификация: Требуется аутентификация
phonedefault_countryexpected_countrydialing_from_countrylanguage
POST /v1/phone/validate/bulk
Кредиты: 1/itemАутентификация: Требуется аутентификация
phonesdefault_countryexpected_countrydialing_from_countrylanguage

Сначала проверяйте. Платите за актуальные телекоммуникационные данные только при необходимости.

DomScan выполняет первый этап: проверяет номера по плану нумерации, приводит их к стандартным форматам и добавляет офлайн-метаданные, а там, где они доступны, официальные сведения о диапазоне или префиксе. Сначала отфильтруйте и распределите номера, а отдельный сервис актуальных данных подключайте только тогда, когда решение зависит от текущего оператора или переноса номера, доступности номера, проверки личности с надлежащим разрешением либо сигналов риска мошенничества от конкретного поставщика.

Один кредит за номер

Проверяйте каждый номер по плану нумерации, прежде чем решать, для каких записей оправдан запрос к сети в реальном времени.

Без телекоммуникационного запроса для каждого номера

DomScan проверяет формат, документированные диапазоны и офлайн-метаданные. Местоположение означает область плана нумерации, а не физическое положение. Оператор или держатель распределения отражает первоначальную связь с диапазоном и не обязательно является текущим оператором после переноса номера. Результат не подтверждает выделение, активность, доступность, доставку SMS или личность абонента.

Контекст официального распределения

Если страна поддерживается, вы увидите статус соответствующего диапазона, его первоначального держателя, источник и сведения о снимке данных. Эти данные описывают диапазон и не определяют текущего оператора или абонента.

Сигналы доверия перед интеграцией

Прозрачная документация, аутентифицированные запросы и видимые сведения о надежности помогают оценить DomScan перед запуском.

Статус сервиса API-артефакты

OpenAPI, Swagger, Postman, CLI, SDK и ссылки MCP доступны в один клик.

API-ключи Защищенный доступ

Аутентифицированные эндпоинты используют API-ключи с понятной стоимостью в кредитах до вызова.

Бесплатный лимит Зарегистрируйтесь Бесплатно

Начните с 10 000 кредитов в месяц и обновляйтесь только при росте использования.

Активен Пример запроса

Начните с примеров curl и HTTP, затем перенесите параметры в код приложения.

Ключевые возможности

Строгая проверка по плану нумерации

Проверяйте длину и последовательность цифр по полным метаданным плана нумерации, а не только по длине.

Стандартизированные форматы

Получайте форматы E.164, международный, национальный и RFC 3966, включая распознанные добавочные номера.

Возможный или действительный

Отличайте номера допустимой длины от диапазонов, признанных планом нумерации.

Тип номера и данные префикса

Определяйте тип номера, местоположение по плану нумерации, возможные часовые пояса, первоначального оператора и поддержку переносимости номера, если эти сведения есть в метаданных.

Набор с учётом страны и короткие номера

Разбирайте национальные номера с указанием страны, формируйте формат набора для страны исходящего вызова и распознавайте региональные короткие номера и номера экстренных служб.

Массовая проверка

Проверяйте до 100 номеров за запрос и получайте отдельный результат для каждого введённого значения.

Офлайн-источники и официальные распределения

Если страна поддерживается, вы увидите статус соответствующего диапазона, его первоначального держателя, источник и сведения о снимке данных. Эти данные описывают диапазон и не определяют текущего оператора или абонента.

Пример запроса

POST /v1/phone/validate bash
curl -X POST https://domscan.net/v1/phone/validate \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+34 612 345 678","expected_country":"ES","dialing_from_country":"US","language":"en"}'

Пример ответа

200 OK json
{
  "input": "+34 612 345 678",
  "normalized_input": "+34 612 345 678",
  "kind": "phone_number",
  "valid": true,
  "possible": true,
  "status": "valid",
  "recommendation": "accept",
  "validation_level": "numbering_plan",
  "reason": null,
  "warnings": [],
  "number": {
    "e164": "+34612345678",
    "international": "+34 612 34 56 78",
    "national": "612 34 56 78",
    "rfc3966": "tel:+34612345678",
    "national_number": "612345678",
    "extension": null,
    "country": "ES",
    "country_name": "Spain",
    "country_calling_code": "34",
    "possible_countries": ["ES"],
    "country_match": true,
    "type": "mobile",
    "non_geographic": false
  },
  "intelligence": {
    "status": "available",
    "kind": "phone_number",
    "coverage": {
      "country": "ES",
      "level": "official_allocation_match",
      "global_numbering_metadata": true,
      "official_snapshot_available": true,
      "official_allocation_match": true,
      "official_source_ids": ["cnmc"],
      "matching_source_ids": ["cnmc"],
      "current_carrier_lookup": false
    },
    "location": {
      "country_name": "Spain",
      "country": "ES",
      "granularity": "country",
      "current_physical_location": false
    },
    "possible_time_zones": {
      "values": ["Europe/Madrid"],
      "current_location": false,
      "inference": "number_prefix"
    },
    "original_prefix_carrier": {
      "name": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
      "source_id": "cnmc",
      "evidence": "official_allocation_record",
      "current_carrier": false,
      "portability_may_change_carrier": true
    },
    "portability": {
      "region_supported": true,
      "current_port_checked": false
    },
    "dialing": {
      "from_country": "US",
      "international": "011 34 612 34 56 78",
      "internationally_diallable": true
    },
    "regulator_allocations": [{
      "authority": "CNMC",
      "category": "mobile",
      "status": "assigned",
      "original_assignee": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
      "assigned_on": "2023-11-03",
      "current_operator": false,
      "individual_number_assignment_checked": false
    }],
    "sources": [{
      "id": "google_libphonenumber",
      "name": "Google libphonenumber metadata",
      "license": "Apache-2.0"
    }, {
      "id": "cnmc",
      "name": "Comisión Nacional de los Mercados y la Competencia (CNMC)",
      "type": "official_regulator_snapshot"
    }]
  },
  "live_checks": {
    "assignment": "not_checked",
    "reachability": "not_checked",
    "current_carrier": "not_checked",
    "subscriber_identity": "not_checked",
    "porting": "not_checked"
  },
  "privacy": {
    "upstream_requests": 0,
    "telecom_provider_queried": false,
    "persisted": false,
    "domscan_edge_relay_used": true,
    "third_party_requests": 0
  },
  "limitations": [
    "NUMBERING_PLAN_ONLY",
    "DOES_NOT_PROVE_ASSIGNMENT",
    "NO_LIVE_TELECOM_CHECKS"
  ],
  "credits_used": 1
}

Заголовок

Что означает действительный телефонный номер?

Действительный номер соответствует документированной длине и последовательности цифр признанного диапазона плана нумерации. Это не означает, что номер выделен абоненту.

Доказывает ли проверка, что номер активен или доступен?

Нет. Проверка по плану нумерации не может подтвердить, что номер выделен, активен, доступен или способен принимать звонки либо SMS.

Возвращает ли API текущего оператора или владельца телефона?

API может вернуть первоначального оператора префикса или держателя распределения регулятора. Ни одно из этих полей не указывает текущего оператора после переноса номера и не идентифицирует абонента или владельца телефона.

Нужно ли указывать страну для национального номера?

Да. Если номер не начинается с международного телефонного кода, укажите страну или регион по умолчанию. Страна также нужна для интерпретации региональных коротких номеров и номеров экстренных служб.

Можно ли проверять телефонные номера массово?

Да. Метод массовой проверки принимает до 100 номеров и возвращает результаты в порядке ввода. Если офлайн-обогащение недоступно, локальная проверка всё равно завершается, а intelligence.status сообщает о резервном режиме.

Связанные инструменты и ресурсы

Коды статуса HTTP

Мы документируем HTTP-коды состояния, которые должен обрабатывать ваш клиент, чтобы различать успешные ответы, проблемы аутентификации, кредиты, лимиты запросов, отсутствующие данные и ошибки вышестоящих сервисов.

OK 200

Запрос выполнен успешно

Неверный запрос 400

Недопустимые параметры

Не авторизован 401

API-ключ или сессия отсутствует либо недействительна.

Требуется оплата 402

Недостаточно кредитов для выполнения этого запроса.

Слишком много запросов 429

Лимит скорости превышен

Ошибка сервера 500

Внутренняя ошибка

Попробуйте данные о номерах бесплатно