# BGP 邻居查询

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

## 接口

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

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

```bash
curl https://ip.czl.net/api/bgp/13335
```

ASN 可以先通过 [IP 归属查询](/docs/query) 的 `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 分钟以上。
