IR21Data · 通信数据，清晰可循

GET/v1/tadig/:code/portability

用途与边界

支持携转的声明不证明任何号码已经携转，也不证明整个地区所有网络都支持。未查询时当前运营商保持 null。 false + declared 是明确不支持；null + unknown 是没有明确布尔声明；null + restricted 是匿名权限隐藏（不含 source）；null + scheduled 是网络或声明未来生效。demo 可匿名完整展示。source 优先使用携转声明来源，否则使用网络来源。此接口不分页，不接受 at；空 networks 不代表不支持。

请求参数

参数	类型 / 位置	说明
`code`	string · path	五位 TADIG，保留多网络结果。

请求示例

cURL / 合成示例

curl 'https://YOUR_IR21DATA_HOST/api/v1/tadig/DEMO1/portability' -H "X-API-Key: $IR21DATA_API_KEY"

成功响应示例

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

JSON

{
  "code": 0,
  "data": {
    "tadig": "DEMO1",
    "access": "full",
    "portability_checked": false,
    "networks": [
      {
        "network_id": "example-network",
        "operator_id": "example-operator",
        "operator_name": "Synthetic carrier",
        "supported": false,
        "status": "declared",
        "source": {
          "source": "synthetic-example",
          "source_published_at": null,
          "effective_at": null,
          "ingested_at": "2026-09-08T00:00:00Z"
        }
      }
    ]
  },
  "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 字段语义

字段	类型	说明
`access / networks`	preview \| full / array	访问级别及网络声明清单。
`supported`	boolean \| null	仅当前有效且明确的声明返回布尔值；未知、受限或未来生效为 null。
`status`	declared \| unknown \| restricted \| scheduled	区分未知、权限隐藏和未生效。
`source / portability_checked`	SourceInfo / false	声明来源与时间；并未查询某个号码的携转状态。

响应、鉴权与错误

数据接口支持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 表示权限不足，409 表示目录或游标版本冲突，429 表示调用限制，503 表示服务或数据源暂不可用。请读取错误响应的 code、message、request_id，详见错误与重试。

ERROR / 示意结构

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