IP归属地查询

GET IP 工具 QPS ≤ 3 并发 ≤ 100 运行中
https://api.fohok.xin/v1/ip

接口说明

IP归属地查询,支持v1精简和v2完整返回

请求参数

参数名 位置 类型 必填 示例
ip query string 必填 1.1.1.1
需查询的IP通过此参数传入
v path string 可选 2
默认为1返回精简版,2为完整版

请求示例

curl
curl -X GET 'https://api.fohok.xin/v1/ip' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"ip":"1.1.1.1","v":"2"}'

查询单个 IP 归属地

curl
curl "https://api.fohok.xin/v1/ip/query?ip=1.1.1.1&lang=zh-CN" \
  -H "Authorization: Bearer fhk_xxxxxxxx"
response
{
  "code": 0,
  "msg": "ok",
  "data": {
    "ip": "1.1.1.1",
    "country": "澳大利亚",
    "province": "新南威尔士州",
    "city": "悉尼",
    "isp": "Cloudflare, Inc.",
    "lat": -33.8591,
    "lng": 151.2002
  },
  "request_id": "req_9f2c...",
  "cost_ms": 6.42
}

响应说明

字段类型说明
code int 业务状态码,0 表示成功
msg string 状态描述
data object 业务数据,由上游接口决定
request_id string 本次请求唯一标识,可用于问题排查
cost_ms float 网关侧处理耗时(毫秒)

响应头附带 X-Request-Id、X-Response-Time、X-Billing-Mode、X-Billing-Tier、X-Token-Cost,便于对账与性能观测。

计费与价梯

计费模式按量扣费per_unit 计量单位次 统计周期按月
价梯累计区间单价(Token)说明
第 1 档 0 – 300 次 5.2000 / 次 起步价
第 2 档 300 – 600 次 4.5000 / 次 累计用量进入本档后按此价
第 3 档 600 – 1,000 次 3.8000 / 次 累计用量进入本档后按此价
第 4 档 1,000 以上 次 3.2000 / 次 最高档,超出仍按此价

累计量按「当前 Key × 该接口」单独统计:你换一个 Key、或调另一个接口,都从各自的累计量算起,互不影响;用量越大单价越低。 每次调用都会在响应头返回 X-Billing-Tier,标明本次消耗归属的价梯档位。

错误码

HTTPerror说明
400bad_request请求参数不合法
401missing_api_key / invalid_api_key缺少或无效的 API Key
402insufficient_balanceToken 余额不足
403api_key_disabled / ip_not_allowedKey 被禁用或 IP 不在白名单
429rate_limited / daily_limit_exceeded触发限流或当日额度用尽
503server_busy / queue_timeout并发超限排队超时
502upstream_error上游服务异常
闽ICP备2026024151号 闽公网安备35058302351237号