IR21Data通信基础数据

DEVELOPER DOCS / API V1

TADIG 网络身份

通过 TADIG 查找网络与组织关系，补充 PLMN 无法完整表达的网络身份。

GET/v1/tadig/:code

用途与边界

无结果表示当前目录没有相关记录。TADIG、PLMN、网络与组织之间允许多对多关系。

请求参数

参数类型 / 位置说明
codestring · 必填 · pathTADIG 标识，例如合成示例 DEMO1。

请求示例

cURL / 合成示例
curl 'https://YOUR_IR21DATA_HOST/api/v1/tadig/DEMO1' \
  -H "X-API-Key: $IR21DATA_API_KEY"

成功响应示例

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

JSON
{
  "code": 0,
  "data": [
    {
      "id": "example-network",
      "operator_id": "example-operator",
      "name": "Synthetic network",
      "tadig": "DEMO1",
      "mcc": "001",
      "mnc": "01",
      "network_type": null,
      "roles": [],
      "capabilities": {
        "number_portability_supported": false
      },
      "e214": [
        {
          "country_code": "1",
          "network_code": "001",
          "prefix": "1001",
          "source": {
            "source": "synthetic-example",
            "source_published_at": null,
            "effective_at": null,
            "ingested_at": "2026-09-08T00:00:00Z"
          }
        }
      ],
      "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 字段语义

字段类型说明
dataNetwork[]网络数组；字段与 PLMN 响应相同。
operator_idstring关联组织，不能按 TADIG 擅自合并组织。
mcc / mncstring | null可能没有 PLMN 信息；null 不补为 000。
sourceSourceInfo每条网络保留独立来源与时间。
e214[]E214Identity[] · optional网络关联的 E.214 声明：country_code、network_code、prefix、source；缺失不推算，保留多值和前导零。

响应、鉴权与错误

数据接口支持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"
}