IP 网段与 ASN API

通过 RDAP 查询 IP 所属网段、持有组织、地区注册机构与 AS 号信息

数据来源：RDAP（APNIC / ARIN / RIPE NCC / LACNIC / AFRINIC，rdap.org 备用）

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

查询 IP 所属网段、组织、国家与 ASN

GET /api/ip/asn

请求参数

  • ip（必填）：IPv4 或 IPv6 公网地址，示例 1.1.1.1

返回字段

  • ip（string）：查询的 IP（规范化后的写法，IPv6 为压缩小写形式）
  • version（string）：IP 版本：IPv4 / IPv6
  • handle（string|null）：网段在 RIR 数据库中的句柄（如 APNIC 为「1.1.1.0 - 1.1.1.255」、ARIN 为 NET-…/AS…）；上游未提供时为 null
  • name（string|null）：网段名称（如 APNIC-LABS、CLOUDFLARENET）；上游未提供时为 null
  • type（string|null）：分配类型，上游原文，如 ASSIGNED PORTABLE、DIRECT ALLOCATION；上游未提供时为 null
  • registry（string|null）：所属地区注册机构：APNIC（亚太）/ ARIN（北美）/ RIPE NCC（欧洲、中东）/ LACNIC（拉美）/ AFRINIC（非洲）；无法判断时为 null
  • country（string|null）：国家或地区代码（ISO 3166-1 两位字母，如 CN、US、AU）；ARIN 等上游不提供时为 null
  • org（string|null）：持有组织名称（registrant 联系人的名称，缺失时取 administrative 联系人）；都没有时为 null
  • description（array）：上游 remarks 中的描述文字（每行一个字符串，已去重）；没有时为空数组
  • description[]（string）：一行描述文字，上游原文（通常为英文）
  • abuseEmail（string|null）：滥用投诉邮箱（abuse 联系人）；上游未提供时为 null
  • created（string|null）：注册时间，ISO 8601 格式，UTC 时区；上游未提供时为 null
  • updated（string|null）：最后修改时间，ISO 8601 格式，UTC 时区；上游未提供时为 null
  • start（string|null）：网段起始地址；上游未提供时为 null
  • end（string|null）：网段结束地址；上游未提供时为 null
  • cidrs（array）：网段的 CIDR 表示（优先取上游 cidr0 扩展，没有时由起止地址计算，最多 64 条）；起止地址缺失时为空数组
  • cidrs[]（string）：CIDR，如 1.1.1.0/24
  • asn（number|null）：该网段的 AS 号（仅当 RDAP 响应含 AS 号引用时有值，如 ARIN 的 originautnums 扩展；APNIC、RIPE 等多数情况下没有，为 null）
  • parentHandle（string|null）：上级网段的句柄；没有时为 null

查询 AS 号的名称、持有组织与注册机构

GET /api/asn

请求参数

  • asn（必填）：AS 号，可带 AS 前缀，如 13335 或 AS4134，示例 13335

返回字段

  • asn（number）：查询的 AS 号
  • handle（string|null）：AS 号在 RIR 数据库中的句柄（如 APNIC 为「1.1.1.0 - 1.1.1.255」、ARIN 为 NET-…/AS…）；上游未提供时为 null
  • name（string|null）：AS 号名称（如 APNIC-LABS、CLOUDFLARENET）；上游未提供时为 null
  • type（string|null）：分配类型，上游原文，如 ASSIGNED PORTABLE、DIRECT ALLOCATION；上游未提供时为 null
  • registry（string|null）：所属地区注册机构：APNIC（亚太）/ ARIN（北美）/ RIPE NCC（欧洲、中东）/ LACNIC（拉美）/ AFRINIC（非洲）；无法判断时为 null
  • country（string|null）：国家或地区代码（ISO 3166-1 两位字母，如 CN、US、AU）；ARIN 等上游不提供时为 null
  • org（string|null）：持有组织名称（registrant 联系人的名称，缺失时取 administrative 联系人）；都没有时为 null
  • description（array）：上游 remarks 中的描述文字（每行一个字符串，已去重）；没有时为空数组
  • description[]（string）：一行描述文字，上游原文（通常为英文）
  • abuseEmail（string|null）：滥用投诉邮箱（abuse 联系人）；上游未提供时为 null
  • created（string|null）：注册时间，ISO 8601 格式，UTC 时区；上游未提供时为 null
  • updated（string|null）：最后修改时间，ISO 8601 格式，UTC 时区；上游未提供时为 null
  • rangeStart（number|null）：该 RDAP 记录覆盖的 AS 号段起点（通常与 asn 相同）；上游未提供时为 null
  • rangeEnd（number|null）：该 RDAP 记录覆盖的 AS 号段终点；上游未提供时为 null
  • status（array）：RDAP 状态，如 active；上游未提供时为空数组
  • status[]（string）：状态值，上游原文