晰联 CELRYN · 通信数据，清晰可循

GET/v1/e164/:number/range-owner

用途与边界

示例号码仅用于说明响应结构，实际结果取决于数据集。生产日志应对带号码的 API 路径脱敏。浏览器工具使用 POST /v1/number/validate 将号码放入请求体，避免写入页面地址。

请求参数

参数	类型 / 位置	说明
`number`	string · 必填 · path	完整国际号码，E.164 使用字符串。
`default_region`	string · 选填 · query	解析本地格式时的默认 ISO2 地区；不作为未命中号码的默认归属。

请求示例

cURL / 合成示例

curl 'https://YOUR_CELRYN_HOST/api/v1/e164/%2B12025550123/range-owner' \
  -H "X-API-Key: $CELRYN_API_KEY"

成功响应示例

以下是结构示例，不是当前在线目录的查询结果。

JSON

{
  "code": 0,
  "data": {
    "input": "+12025550123",
    "e164": "+12025550123",
    "country_code": "1",
    "country_iso2": "US",
    "country_name_cn": "美国",
    "country_name_en": "United States",
    "number_type": "FIXED_LINE_OR_MOBILE",
    "possible": true,
    "valid": true,
    "match_status": "unknown",
    "matches": [],
    "original_carrier": null,
    "current_carrier": null,
    "is_ported": null,
    "portability_checked": false
  },
  "meta": {
    "request_id": "example-request-id",
    "dataset_version": "example-v1",
    "source_mode": "demo",
    "source_published_at": null,
    "ingested_at": "2026-09-08T00:00:00Z"
  }
}

data 字段语义

字段	类型	说明
`input / e164`	string / string \| null	原始输入与标准化结果。
`country_code / country_iso2`	string \| null	国家码与地区；共享国家码不得直接默认某一地区。
`country_name_cn / country_name_en`	string \| null	地区中英文名称。
`possible / valid / number_type`	boolean / boolean / string	编号长度可能性、依据编号库或已生效号段声明的有效性和类型，不代表活跃或可达。
`match_status`	enum	matched / unknown / ambiguous / invalid / scheduled。
`matches`	array	并列的 range、operator、network 候选，不擅自选择默认候选。
`original_carrier`	string \| null	原始声明归属；未知或无法确定时为 null。
`current_carrier / is_ported`	null / null	当前版本未查询携转，不返回 false 冒充验证。
`portability_checked`	false	明确表示未查询单号携转状态。
`numbering_metadata_valid`	boolean · 可选	编号库是否匹配；false 不应否定已生效的明确号段声明。
`validation_basis`	enum · 可选	numbering_metadata 编号库规则；range_declaration 已生效号段声明；unconfirmed 未确认。未来声明仍为 scheduled，不能提前确认有效。

响应、鉴权与错误

数据接口支持X-API-Key 或同源 Cookie 会话。匿名访问为受限公共投影，完整字段权限由 API 服务执行。JSON 成功响应统一为{code:0,data,meta}；文件导出直接返回文件。

字段	说明
`meta.request_id`	本次请求标识，用于排查错误，不包含密钥。
`meta.dataset_version / source_mode`	当前数据版本与 demo / ir21 / reference / mixed 来源模式。
`meta.source_published_at`	源发布时间；未知为 null。
`meta.ingested_at`	平台导入时间，ISO 格式 UTC。

400 表示参数不符，401 表示需要有效凭证，403 表示权限不足，429 表示调用限制，503 表示服务或数据源暂不可用。请读取错误响应的 code、message、request_id，详见错误与重试。

ERROR / 示意结构

{
  "code": "EXAMPLE_ERROR_CODE",
  "message": "具体错误原因由服务端返回",
  "request_id": "example-request-id"
}