IP归属地查询
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,便于对账与性能观测。
计费与价梯
| 价梯 | 累计区间 | 单价(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,标明本次消耗归属的价梯档位。
错误码
| HTTP | error | 说明 |
|---|---|---|
| 400 | bad_request | 请求参数不合法 |
| 401 | missing_api_key / invalid_api_key | 缺少或无效的 API Key |
| 402 | insufficient_balance | Token 余额不足 |
| 403 | api_key_disabled / ip_not_allowed | Key 被禁用或 IP 不在白名单 |
| 429 | rate_limited / daily_limit_exceeded | 触发限流或当日额度用尽 |
| 503 | server_busy / queue_timeout | 并发超限排队超时 |
| 502 | upstream_error | 上游服务异常 |