GET
/v1/tadig/:code用途与边界
无结果表示当前目录没有相关记录。TADIG、PLMN、网络与组织之间允许多对多关系。
请求参数
| 参数 | 类型 / 位置 | 说明 |
|---|---|---|
code | string · 必填 · path | TADIG 标识,例如合成示例 DEMO1。 |
请求示例
cURL / 合成示例
curl 'https://YOUR_CELRYN_HOST/api/v1/tadig/DEMO1' \
-H "X-API-Key: $CELRYN_API_KEY"成功响应示例
以下是结构示例,不是当前在线目录的查询结果。
JSON
{
"code": 0,
"data": [],
"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 字段语义
| 字段 | 类型 | 说明 |
|---|---|---|
data | Network[] | 网络数组;字段与 PLMN 响应相同。 |
operator_id | string | 关联组织,不能按 TADIG 擅自合并组织。 |
mcc / mnc | string | null | 可能没有 PLMN 信息;null 不补为 000。 |
source | SourceInfo | 每条网络保留独立来源与时间。 |
响应、鉴权与错误
数据接口支持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"
}