电话号码情报与验证 API

分类安全

API 端点 2

主要功能 7

常见问题解答 6

集成前可见的信任信号

透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。

实时服务状态

集成前，请先查看实时服务运行状况和文档中说明的失败响应。

OpenAPI API 资料

OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。

API 密钥 受保护访问

认证端点使用 API 密钥，并在调用前清楚显示积分成本。

10,000 免费额度

从每月 10,000 积分开始，只有在用量增长时再升级。

这个 API 可以帮你交付什么

把此页面当作生产集成简报：端点、示例、响应结构，以及把 DomScan 接入产品所需的工作流组件。

产品工作流

把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。

分析自动化

用计划任务、告警和可复现的调查步骤替代重复的人工查询。

干净的 JSON 数据

使用可预测字段、已记录的状态码和积分成本，而不是抓取供应商页面。

AI 和运维工具

通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。

集成流程

从第一次请求到可重复生产使用的简单路径。

一次认证

使用文档中的请求头发送 API 密钥，并在服务之间保持请求一致。

用示例查询

从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。

运行和监控

使用状态码、积分成本和响应字段构建重试、日志和告警。

开发者工具包

从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。

OpenAPI 架构

生成客户端，或检查每种请求和响应结构。

Postman 集合

导入现成请求，用于手动测试和团队交接。

SDK 和 CLI

使用维护中的包和命令行流程，避免编写样板代码。

MCP 集成

把域名情报暴露给 AI 代理和内部助手工作流。

参数和响应映射

在把端点接入客户端前，快速查看输入、输出字段和状态码。

请求参数

参数

phonedefault_countryexpected_countrydialing_from_countrylanguagephones

响应字段

响应示例

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164

状态覆盖

HTTP 状态码

200400401402429500502503504

API 端点

POST /v1/phone/validate

积分: 1身份验证: 需要身份验证

phonedefault_countryexpected_countrydialing_from_countrylanguage

POST /v1/phone/validate/bulk

积分: 1身份验证: 需要身份验证

phonesdefault_countryexpected_countrydialing_from_countrylanguage

集成前可见的信任信号

透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。

服务状态 API 资料

OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。

API 密钥 受保护访问

认证端点使用 API 密钥，并在调用前清楚显示积分成本。

免费额度 免费注册

从每月 10,000 积分开始，只有在用量增长时再升级。

活跃请求示例

从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。

主要功能

严格的号码规划验证

使用完整的号码规划元数据检查长度和数字模式，而不是只检查长度。

标准化格式

返回E.164、国际、国内和RFC 3966格式，包括已解析的分机号。

可能号码与有效号码

区分长度合理的号码与号码规划已识别的号段。

号码类型与号段情报

在元数据支持时，识别号码类型、号码规划归属地区、可能的时区、号段原始运营商和号码携转支持情况。

按国家拨号与短号码识别

指定国家解析国内号码，生成适用于呼叫方所在地的拨号格式，并识别地区短号码和紧急号码。

批量验证

每个请求最多验证100个号码，并为每项输入返回独立结果。

离线数据源与官方分配信息

在DomScan基础设施上使用离线元数据和监管机构公开数据快照。匹配结果会提供数据来源、许可证、更新日期和原始分配背景。

请求示例

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
}

常见问题解答

电话号码有效是什么意思？

有效表示该号码符合某个已识别号码规划范围所记录的长度和数字模式。这并不表示该号码已分配给用户。

验证能否证明号码处于使用中或可联通？

不能。号码规划验证无法确认号码是否已分配、正在使用、可联通或能够接收电话或短信。

API会返回当前运营商或电话号码持有人吗？

API可能返回号段原始运营商或监管机构记录的分配主体。这两个字段都不代表号码携转后的当前运营商，也不能识别用户或电话号码持有人。

验证国内电话号码需要指定国家吗？

需要。如果号码不以国际区号开头，请提供默认国家或地区。解析地区短号码和紧急号码时也必须指定国家。

情报数据来自哪里？

全球元数据来自Google libphonenumber。官方号段和前缀依据还可能来自CNMC、ARCEP、Bundesnetzagentur、日本的MIC、奥地利的RTR、Nkom、波兰的UKE、台湾的MODA、美国的NANPA以及加拿大的CNA/CNAC发布的公开数据快照。美国和加拿大的记录描述NPA-NXX中心局代码的状态和原始代码持有方，并不代表已携转号码的当前运营商。每项结果都会注明数据来源、快照日期和覆盖级别。归属地区和时区描述的是号码规划中的号段，并非手机当前所在位置。

可以批量验证电话号码吗？

可以。批量端点最多接受100个号码，并按输入顺序返回结果。如果离线增强不可用，本地验证仍会完成，intelligence.status会注明回退状态。

HTTP 状态码

我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。

成功 200

请求成功

请求错误 400

参数无效

未授权 401

API 密钥或会话缺失或无效。

需要付款 402

没有足够额度来执行此请求。

请求过多 429

超出速率限制

服务器错误 500

内部错误

网关错误 502

上游 RDAP 错误

服务不可用 503

上游服务不可用或正在临时限流。

网关超时 504

上游查询已超时。

免费试用电话号码情报

查看完整 API 文档 API 接口

电话号码情报 API

集成前可见的信任信号

这个 API 可以帮你交付什么

集成流程

开发者工具包

参数和响应映射

API 端点

集成前可见的信任信号

主要功能

请求示例

响应示例

常见问题解答

相关工具和资源

HTTP 状态码