Appearance

IP9返回的每个字段都是啥？一份说明书 ​

接口用多了你会发现，很多文档写得云里雾里，字段名缩写一堆，根本不知道啥意思。IP9 的接口还算友好，但有些字段（比如 long_ip、big_area）不细看还真不明白。

这篇文章把 IP9 返回的字段挨个讲一遍，当一份说明书用。

先看完整返回 ​

json
{
  "ret": 200,
  "data": {
    "ip": "58.30.0.0",
    "country": "中国",
    "country_code": "cn",
    "prov": "北京",
    "city": "北京",
    "city_code": "beijing",
    "city_short_code": "bj",
    "post_code": "100000",
    "area_code": "010",
    "isp": "中国移动",
    "lng": "116.41",
    "lat": "39.93",
    "long_ip": 975044608,
    "big_area": "华北"
  },
  "qt": 0.001
}

最外层两个 ​

ret：状态码，200 表示正常。非200就是出问题了，调接口第一件事就是判断它。

qt：查询耗时，单位秒。可以用来监控接口性能，正常都是毫秒级（0.001这种）。

data 里的基础字段 ​

ip：你查询的那个IP，原样返回。批量查询时用来对应结果，别把结果弄串了。

country：国家/地区中文名，比如"中国"。海外IP返回"美国""日本"这种。

country_code：国家简码，ISO标准，比如中国是 cn、美国是 us。这个字段做判断特别好用，因为它是标准化的，不会出现"美国"和"米国"这种分歧。

prov：省份，比如"北京""广东"。注意直辖市这里就是"北京"本身。

city：城市，比如"北京""广州"。

city_code：城市简码，全拼，比如 beijing、guangzhou。

city_short_code：更短的简码，比如 bj、gz。做URL、做标签的时候用这个很方便。

本地化常用字段 ​

post_code：邮政编码。做本地化展示、地址联想的时候用得上。

area_code：电话区号，比如北京是 010。做客服、联系电话展示的时候可以参考。

isp：运营商，比如"中国移动""中国联通""中国电信"。能看出用户用什么网络，判断网络环境很有用。

地理字段 ​

lng / lat：城市中心的经纬度。注意是城市中心点，不是用户精确位置，别当GPS用（详情看我"经纬度准不准"那篇）。

long_ip：IP的长整型数值。就是把IP地址转成数字，比如 58.30.0.0 → 975044608。做区间判断、数据库索引的时候可能用到。

big_area：国内大区，比如"华北""华南""华东"。做区域统计、大区维度的报表，直接用它分组，特别省事。

VIP 字段（需要对应权限） ​

这几个字段免费版可能拿不到，是增值服务的：

ip_type：IP类型，ISP（家庭宽带）/BUS（企业专线）/IDC（机房数据中心）。风控场景最常用的字段，判断流量是不是真人。

ip_asn：AS号，比如 AS17429。懂网络的能看出这个IP属于哪家机构，做网络分析用。

area：区县，比如"东城"。比城市更细一层，做本地生活、精准运营才有价值。

一个小总结 ​

用IP9的接口，记住这几点就够用了：

  • 做展示：prov + city + isp 就够；
  • 做判断：country_code + ip_type 是主力；
  • 做统计：big_area + prov 分组很方便；
  • 做可视化：lng + lat 画图，但记住它是城市中心。

接口地址：https://ip9.com.cn/get?ip=你要查的IP

完整文档在官网：https://www.ip9.com.cn