健康检查 API 与 curl
调用兼容健康端点并正确解释来源、字段与未知值；它与 v1 本地快照 API、网页多源模型分别使用。
更新于 · 出口观测台
请求与来源
GET /api/ip/health 使用 Net.Coffee 的 trust_score 与特征字段。它是既有兼容端点，不是网页 v5 多来源质量模型，也不是 v1 本地快照分类。来源失败会返回错误，不用示例结果代替。
- ip
- 可选公网 IPv4/IPv6；省略时使用可信边缘的访客地址。未部署边缘或本地开发时须明确指定。
- format
- 可选 json（默认）或 text。其他值返回 400。
curl -sS "https://ip.oocore.com/api/ip/health?ip=1.1.1.1&format=text"curl -sS "https://ip.oocore.com/api/ip/health?ip=1.1.1.1"结构示例，不是实时检测结果
下面用 null/unknown 展示缺失字段的结构，时间仅为示例。不要将其当作 1.1.1.1 的实时画像。text 输出会把 null 写为 unknown。
{
"ip": "1.1.1.1",
"checked_at": "2026-11-02T00:00:00.000Z",
"score": null,
"status": "unknown",
"country": null,
"region": null,
"city": null,
"isp": null,
"asn": null,
"flags": {
"residential": null,
"datacenter": null,
"mobile": null,
"vpn": null,
"proxy": null,
"tor": null,
"crawler": null,
"abuser": null
}
}IP health
ip: 1.1.1.1
checked_at: 2026-11-02T00:00:00.000Z
score: unknown
status: unknown
country: unknown
region: unknown
city: unknown
isp: unknown
asn: unknown
residential: unknown
datacenter: unknown
mobile: unknown
vpn: unknown
proxy: unknown
tor: unknown
crawler: unknown
abuser: unknown字段与错误
score 是来源 trust_score 的 0–100 数值，缺失为 null；status 按该兼容接口的 75/45 阈值分 good/moderate/poor，缺失为 unknown。这些分档不可直接与网页质量分换算，也不是任何平台的官方风控结果。
地址或 format 无效返回 400；无法取得可信访客地址返回 503；来源返回的地址无效或不匹配返回 502。限流响应为 429，应降低请求频率。保留错误与未知，不将其转为 0 分或“通过”。
- checked_at
- 本接口执行查询的时间，不是上游数据库最后更新时间。
- country / region / city / isp / asn
- 来源提供的归属与运营商资料；缺失为 null。注册地与使用位置应分别理解。
- flags.*
- residential、datacenter、mobile、vpn、proxy、tor、crawler、abuser 为布尔值或 null。命中不等于恶意，未命中不等于平台可用。
当前出口与脚本复测
切换节点后再发起请求，核对来源、地址与查询时间后比较。缺失或错误时停止作出通过判断；不要仅用总分做自动风控决策。API 响应禁止索引和缓存，不影响 curl 调用。
curl -sS "https://ip.oocore.com/api/ip/health" | jq '{ip,score,status,isp,flags}'curl -sS "https://ip.oocore.com/api/ip/health?ip=8.8.8.8"SCORE=$(curl -fsS "https://ip.oocore.com/api/ip/health?ip=$NODE_IP" | jq -er '.score // empty') || { echo "No valid score" >&2; exit 1; }