🌐 互联网基础设施数据

查询 IP 地址归属、BGP 路由安全 (RPKI) 验证和域名 DNSSEC 部署状态。所有接口通过 Authorization: Bearer YOUR_API_KEY 认证。

API 参考

GET https://api.deepshields.com/v1/security/ip/{ip}

查询指定 IP 地址的地理位置、WHOIS 注册信息、网络前缀和 ASN 归属。

路径参数

参数	类型	说明
ip	string	IPv4 或 IPv6 地址，如 `8.8.8.8`

返回值

字段	类型	说明
ip	string	查询的 IP 地址
country	string	国家代码（ISO 3166-1）
city	string	城市名称
asn	string	自治系统号
holder	string	ASN 持有者 / 组织名称
prefix	string	所属网络前缀（CIDR）

示例

IP 情报

使用 GET https://api.deepshields.com/v1/security/ip/{ip} 查询 IP 地址的地理位置、WHOIS 注册信息、网络前缀和 ASN 归属。

PYTHON

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get(
    "https://api.deepshields.com/v1/security/ip/8.8.8.8",
    headers=headers
)
data = resp.json()
print(f"IP: {data.get('ip')}")
print(f"Country: {data.get('country')}")
print(f"ASN: {data.get('asn')}")
print(f"Org: {data.get('holder')}")

执行结果

点击「执行」查看结果

GET https://api.deepshields.com/v1/security/rpki/{resource}

验证 IP 前缀或 ASN 的 RPKI 状态，检查 BGP 路由声明是否经过授权。

路径参数

参数	类型	说明
resource	string	IP 前缀（如 `1.1.1.0/24`）或 ASN（如 `AS13335`）

返回值

字段	类型	说明
resource	string	查询的资源标识
type	string	资源类型：`prefix` 或 `asn`
vrps	array	VRP 列表，每项含 `prefix`、`maxLength`、`asn`、`status`

RPKI 验证

使用 GET https://api.deepshields.com/v1/security/rpki/{resource} 验证 RPKI 状态。

PYTHON

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get(
    "https://api.deepshields.com/v1/security/rpki/AS13335",
    headers=headers
)
data = resp.json()
print(f"Resource: {data.get('resource')}")
print(f"VRPs: {len(data.get('vrps', []))}")
for vrp in data.get('vrps', [])[:3]:
    print(f"  {vrp.get('prefix')} max={vrp.get('maxLength')}")

执行结果

点击「执行」查看结果

GET https://api.deepshields.com/v1/security/dnssec/{domain}

检测域名 DNSSEC 部署状态，验证 DNS 信任链完整性。

路径参数

参数	类型	说明
domain	string	域名，如 `cloudflare.com`

返回值

字段	类型	说明
domain	string	查询的域名
dnssec_status	string	DNSSEC 状态：`secure` / `insecure` / `bogus`
chain	array	DNS 信任链详情

DNSSEC 检测

使用 GET https://api.deepshields.com/v1/security/dnssec/{domain} 检测 DNSSEC 部署状态。

PYTHON

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get(
    "https://api.deepshields.com/v1/security/dnssec/cloudflare.com",
    headers=headers
)
data = resp.json()
print(f"Domain: {data.get('domain')}")
print(f"DNSSEC: {data.get('dnssec_status')}")

执行结果

点击「执行」查看结果