POST公开旧版IP归属地迁移vv1

IP 定位(旧版)

旧 Ip 迁移:IPv4 归属地查询,返回国家/地区/城市/时区/运营商与拼接地址,24 小时进程内缓存。

/api/Ip
在线调试
频率限制按方案
每日额度按方案
所需权限无

接口说明

旧 Ip 迁移:IPv4 归属地查询,返回国家/地区/城市/时区/运营商与拼接地址,24 小时进程内缓存。

请求参数

请求体为 JSON;未在接口定义中列出的字段一般会被忽略,但个别 Provider 单独校验的接口仍可能拒绝未声明字段;已定义字段仍会做类型、长度与枚举校验。

字段类型说明
0string旧路径参数:同 ip
ipstring要查询的 IPv4;省略时取调用方来源 IP
typestring旧返回格式参数;新平台统一 JSON
cacheunion传任意真值可跳过缓存,强制重新查询

返回参数

成功响应中 data 内的字段(不含信封的 code / message / meta)。未列出的字段可能随版本增加,请忽略未知字段。

请求示例

request.json
{
  "ip": "8.8.8.8"
}

返回示例

response.json
{
  "code": 1,
  "data": {
    "IP": "8.8.8.8",
    "city": "Mountain View",
    "region": "California",
    "address": "United States California Mountain View",
    "country": "United States",
    "is-cache": false,
    "timezone": "America/Chicago",
    "organization": "Google"
  },
  "message": "United States California Mountain View"
}

所有接口统一返回 { code, message, data, error_code?, details?, meta }。 成功 code = 1;失败 code 为唯一负数(如 -10001)并给出结构化 error_code, 错误码说明 →