Перед интеграцией проверьте состояние сервиса в реальном времени и документированные ответы при сбоях.
Используется сотрудниками известных компаний
Сигналы доверия перед интеграцией
Прозрачная документация, аутентифицированные запросы и видимые сведения о надежности помогают оценить DomScan перед запуском.
OpenAPI, Swagger, Postman, CLI, SDK и ссылки MCP доступны в один клик.
Аутентифицированные эндпоинты используют API-ключи с понятной стоимостью в кредитах до вызова.
Начните с 10 000 кредитов в месяц и обновляйтесь только при росте использования.
Что помогает запустить эта API
Используйте эту страницу как производственный бриф: конечные точки, примеры, форма ответа и элементы workflow для подключения DomScan к вашему продукту.
Встраивайте проверки доменов, DNS-интеллект, сигналы риска или обогащение в онбординг, поиск и внутренние инструменты.
Заменяйте повторяющиеся ручные проверки расписаниями, оповещениями и воспроизводимыми шагами расследования.
Используйте предсказуемые поля, документированные коды состояния и стоимость в кредитах вместо scraping страниц провайдеров.
Передавайте данные агентам, дашбордам, SOAR-плейбукам и CRM через OpenAPI, SDK, Postman или MCP.
Интеграционный workflow
Простой путь от первого запроса до повторяемого использования в продакшене.
Передавайте API-ключ в документированном заголовке и сохраняйте единый формат запросов между сервисами.
Начните с примеров curl и HTTP, затем перенесите параметры в код приложения.
Используйте коды состояния, стоимость кредитов и поля ответа для retries, логов и alerts.
Набор разработчика
Переходите к машиночитаемой документации, коллекциям запросов, SDK или инструментам для агентов.
Генерируйте клиенты или изучайте форму каждого запроса и ответа.
Коллекция PostmanИмпортируйте готовые запросы для ручного тестирования и передачи команде.
SDK и CLIИспользуйте поддерживаемые пакеты и командную строку вместо написания boilerplate.
Интеграция MCPОткрывайте доменную разведку AI-агентам и внутренним ассистентам.
Карта параметров и ответа
Просмотрите входы, поля ответа и коды состояния перед подключением endpoint к клиенту.
Параметр
Пример ответа
Коды статуса HTTP
Конечные точки
/v1/phone/validate
/v1/phone/validate/bulk
Сначала проверяйте. Платите за актуальные телекоммуникационные данные только при необходимости.
DomScan выполняет первый этап: проверяет номера по плану нумерации, приводит их к стандартным форматам и добавляет офлайн-метаданные, а там, где они доступны, официальные сведения о диапазоне или префиксе. Сначала отфильтруйте и распределите номера, а отдельный сервис актуальных данных подключайте только тогда, когда решение зависит от текущего оператора или переноса номера, доступности номера, проверки личности с надлежащим разрешением либо сигналов риска мошенничества от конкретного поставщика.
Проверяйте каждый номер по плану нумерации, прежде чем решать, для каких записей оправдан запрос к сети в реальном времени.
DomScan проверяет формат, документированные диапазоны и офлайн-метаданные. Местоположение означает область плана нумерации, а не физическое положение. Оператор или держатель распределения отражает первоначальную связь с диапазоном и не обязательно является текущим оператором после переноса номера. Результат не подтверждает выделение, активность, доступность, доставку SMS или личность абонента.
Если страна поддерживается, вы увидите статус соответствующего диапазона, его первоначального держателя, источник и сведения о снимке данных. Эти данные описывают диапазон и не определяют текущего оператора или абонента.
Сигналы доверия перед интеграцией
Прозрачная документация, аутентифицированные запросы и видимые сведения о надежности помогают оценить DomScan перед запуском.
OpenAPI, Swagger, Postman, CLI, SDK и ссылки MCP доступны в один клик.
Аутентифицированные эндпоинты используют API-ключи с понятной стоимостью в кредитах до вызова.
Начните с 10 000 кредитов в месяц и обновляйтесь только при росте использования.
Начните с примеров curl и HTTP, затем перенесите параметры в код приложения.
Ключевые возможности
Проверяйте длину и последовательность цифр по полным метаданным плана нумерации, а не только по длине.
Получайте форматы E.164, международный, национальный и RFC 3966, включая распознанные добавочные номера.
Отличайте номера допустимой длины от диапазонов, признанных планом нумерации.
Определяйте тип номера, местоположение по плану нумерации, возможные часовые пояса, первоначального оператора и поддержку переносимости номера, если эти сведения есть в метаданных.
Разбирайте национальные номера с указанием страны, формируйте формат набора для страны исходящего вызова и распознавайте региональные короткие номера и номера экстренных служб.
Проверяйте до 100 номеров за запрос и получайте отдельный результат для каждого введённого значения.
Если страна поддерживается, вы увидите статус соответствующего диапазона, его первоначального держателя, источник и сведения о снимке данных. Эти данные описывают диапазон и не определяют текущего оператора или абонента.
Пример запроса
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"}'
Пример ответа
{
"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 может вернуть первоначального оператора префикса или держателя распределения регулятора. Ни одно из этих полей не указывает текущего оператора после переноса номера и не идентифицирует абонента или владельца телефона.
Да. Если номер не начинается с международного телефонного кода, укажите страну или регион по умолчанию. Страна также нужна для интерпретации региональных коротких номеров и номеров экстренных служб.
Да. Метод массовой проверки принимает до 100 номеров и возвращает результаты в порядке ввода. Если офлайн-обогащение недоступно, локальная проверка всё равно завершается, а intelligence.status сообщает о резервном режиме.
Связанные инструменты и ресурсы
Коды статуса HTTP
Мы документируем HTTP-коды состояния, которые должен обрабатывать ваш клиент, чтобы различать успешные ответы, проблемы аутентификации, кредиты, лимиты запросов, отсутствующие данные и ошибки вышестоящих сервисов.
Запрос выполнен успешно
Недопустимые параметры
API-ключ или сессия отсутствует либо недействительна.
Недостаточно кредитов для выполнения этого запроса.
Лимит скорости превышен
Внутренняя ошибка
Попробуйте данные о номерах бесплатно