接口参考
BGP 邻居查询
查询某个自治系统 (ASN) 的上游、下游邻居, 数据来自 RIPEstat 的 RIS 路由观测。返回结构遵循 统一响应格式。
接口
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /api/bgp/:asn | 查询 ASN 的上下游邻居 |
路径参数 asn 为 1 ~ 4294967295 的整数, 不带 AS 前缀, 例如 /api/bgp/13335。
Shell
curl https://ip.czl.net/api/bgp/13335ASN 可以先通过 IP 归属查询 的 as.number 字段拿到。
响应示例
JSON
{
"code": 200,
"data": {
"centerAsn": 13335,
"centerName": "CLOUDFLARENET",
"upstreams": [
{ "asn": 174, "type": "left", "power": 120, "v4Peer": 300, "v6Peer": 120 }
],
"downstreams": [
{ "asn": 999, "type": "right", "power": 10, "v4Peer": 40, "v6Peer": 15 }
],
"uncertain": [],
"allPeers": []
},
"msg": "success"
}allPeers 是 upstreams、downstreams、uncertain 三组邻居的合集, 示例里省略了内容。
字段说明
| 字段 | 说明 |
|---|---|
centerAsn / centerName | 被查 ASN 与持有者名称 |
upstreams | 上游邻居数组 |
downstreams | 下游邻居数组 |
uncertain | 无法判断方向的邻居数组 |
allPeers | 全部邻居合集 |
邻居对象
| 字段 | 说明 |
|---|---|
asn | 邻居 ASN |
type | left = 上游, right = 下游, uncertain = 不确定 |
power | 观测到的路径数, 越大说明连接越重要 |
v4Peer / v6Peer | 观测到该邻居的 IPv4 / IPv6 RIS 节点数 |
错误
| code | 场景 |
|---|---|
400 | asn 不是 1 ~ 4294967295 的整数 |
404 | RIPEstat 没有该 ASN 的数据 |
408 | 上游查询超时 |
429 | 超过 60 次 / 分钟, 或 RIPEstat 限流 |
503 | RIPEstat 暂不可用 |
500 | 其他查询失败 |
成功响应带 Cache-Control: public, max-age=1800; 邻居关系变化很慢, 调用方可以按 ASN 缓存 30 分钟以上。