/api/v1/lookup?q=1.1.1.1IP、域名与 ASN
返回统一的网络身份、位置、ASN、网段、网络类型、风险信号、来源、置信度、覆盖状态、数据提示与查询时间。
开发者 API · v1
结构清晰的网络情报接口
测试网站正在使用的标准化接口、查看原始 JSON，并明确区分实测、推测和暂不可用的数据。API 控制台
当前接口API 控制台
构造请求并直接调用当前部署的真实接口。
$
curl -sS "/api/v1/lookup?q=1.1.1.1"响应结果
{ }运行请求后可在这里查看响应。
REST · JSON
API 参考
提供五个只读查询接口，含每次最多 10 项的批量查询；所有响应均为 JSON，并说明数据来源或覆盖状态。
/api/v1/compat/batch批量查询
一次 JSON 请求可提交 1–10 个不同的 IP、域名或 ASN；每项独立返回状态和标准化结果。
/api/v1/tools?mode=dns加密 DNS 查询
查询 A、AAAA、MX、NS、TXT、CNAME、SOA、CAA 和 PTR 记录，并显示 DNSSEC 校验状态。
/api/v1/tools?mode=rdap注册信息
通过 RDAP 引导找到对应注册局，返回域名、IP 与 ASN 的注册摘要。
/api/v1/status运行状态
查看应用版本、接口列表和运行状态；上游数据覆盖以每次查询结果为准。
接口响应必须如实说明数据覆盖。
免费增强数据源不可用时，核心身份信息仍可成功返回。此时 degraded 为 true，warnings 说明缺失内容，未知风险不会被误报为纯净。
IP 查询响应字段
- ip, version
- 解析后的网络地址与 IP 协议版本。
- asn, cidr, isp
- 路由与网络归属信息，不等同实际使用者。
- risk, evidence
- 已测量的风险标记与评分依据；缺失时为 null。
- source, confidence
- 来源标识与地理置信度；不代表其他字段同样可信。
- degraded, warnings
- 明确标记部分数据缺失及对应提示。
错误码与缓存
- 400 / 422
- 查询内容缺失、格式无效或不受支持；具体状态码以接口响应为准。
- 502
- 必需的数据服务请求失败，错误以 JSON 返回。
- 200 + degraded
- 查询已完成，但部分补充数据缺失。
- 缓存
- 成功的 IP 查询可被缓存；有效期以服务配置为准。
隐私与访问控制
- 只读查询
- 上述查询接口不修改账户或网络配置。
- 接口密钥
- 当前本地预览的查询接口无需应用密钥；其他环境以其访问策略为准。
- 访问策略
- 访问权限、认证与限流由目标环境决定；本地预览不证明公网访问已开放。
- 查询历史
- 查询历史保存在当前设备浏览器中，查询 API 不写入这份记录。