创建 API Key、在线调试、查看文档与代码示例。通过 API 将 IP 质量检测集成到你的应用或脚本中。
输入 API Key 和 IP，直接发请求看真实返回。Key 只存浏览器。
注册并登录，获得专属积分账户
在工作台创建 Key，复制保存（只显示一次）
每次调用消耗 1 积分，确保余额充足
用代码示例或在线控制台发请求
支持两种方式传递 API Key，任选其一：
https://api.ipjiance.com/api/geoip?key=sk-your-api-key&ip=8.8.8.8&lang=zhhttps://api.ipjiance.com/api/geoip?ip=8.8.8.8&lang=en
Authorization: Bearer sk-your-api-key/api/geoipIP 质量检测主接口。需 API Key 鉴权，每次消耗 1 积分。
| 参数 | 必填 | 说明 |
|---|---|---|
| ip | 是 | 公网 IPv4/IPv6 地址 |
| lang | 否 | 评语语言 zh/en |
| key | 二选一 | API Key 或 Authorization 头 |
# curl
curl "https://api.ipjiance.com/api/geoip?ip=8.8.8.8&lang=zh" \
-H "Authorization: Bearer sk-your-api-key"
# 或用 query 参数
curl "https://api.ipjiance.com/api/geoip?key=sk-your-api-key&ip=8.8.8.8"| 字段 | 类型 | 说明 |
|---|---|---|
| ip | string | 查询的 IP 地址 |
| country_code | string | 国家代码(ISO) |
| city | string|null | 城市 |
| longitude/latitude | float|null | 经纬度 |
| time_zone | string|null | 时区 |
| isp | string|null | 网络提供商 |
| organization | string|null | 组织 |
| asn | string|null | 自治系统号 |
| connection_type | string|null | 连接类型 |
| user_type | string|null | 使用者类型 |
| is_anonymous_vpn | bool | 匿名 VPN |
| is_public_proxy | bool | 公共代理 |
| is_tor_exit_node | bool | Tor 出口节点 |
| is_hosting_provider | bool | 机房/数据中心 |
| is_blacklist | bool | 黑名单 |
| is_abuser | bool | 滥用行为 |
| is_attacker | bool | 攻击行为 |
| user_count | int | 使用人数(>1 可能共享) |
| static_ip_score | float | 静态 IP 分数 |
| points | int | 综合评分(0-150) |
| evaluate | string | 评语(按 lang) |
| HTTP | 错误码 | 含义 | 处理建议 |
|---|---|---|---|
| 200 | success | 请求成功 | 处理 data |
| 400 | IP_INVALID | IP 格式错误 | 检查 ip 参数 |
| 400 | IP_NOT_PUBLIC | 非公网 IP | 用公网 IP |
| 401 | APIKEY_INVALID | Key 无效/已禁用 | 检查 Key |
| 402 | CREDIT_INSUFFICIENT | 余额不足 | 充值 |
| 429 | RATE_LIMIT | 请求过快 | 降低频率 |
| 503 | DETECT_FAILED | 检测服务不可用 | 稍后重试(已退还) |