使用说明
BGP 邻居查询

接口参考

BGP 邻居查询

本页目录

查询某个自治系统 (ASN) 的上游、下游邻居, 数据来自 RIPEstat 的 RIS 路由观测。返回结构遵循 统一响应格式。

接口

方法路径说明
GET/api/bgp/:asn查询 ASN 的上下游邻居

路径参数 asn 为 1 ~ 4294967295 的整数, 不带 AS 前缀, 例如 /api/bgp/13335。

Shell
curl https://ip.czl.net/api/bgp/13335

ASN 可以先通过 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
typeleft = 上游, right = 下游, uncertain = 不确定
power观测到的路径数, 越大说明连接越重要
v4Peer / v6Peer观测到该邻居的 IPv4 / IPv6 RIS 节点数

错误

code场景
400asn 不是 1 ~ 4294967295 的整数
404RIPEstat 没有该 ASN 的数据
408上游查询超时
429超过 60 次 / 分钟, 或 RIPEstat 限流
503RIPEstat 暂不可用
500其他查询失败

成功响应带 Cache-Control: public, max-age=1800; 邻居关系变化很慢, 调用方可以按 ASN 缓存 30 分钟以上。