IP 归属地 API

查询 IP 归属地（默认调用者 IP）

GET /api/ip

请求参数

• ip：IPv4 或 IPv6 地址，留空为调用者 IP，示例 114.114.114.114

返回字段

• ip（string）：实际查询的 IP 地址（IPv4 映射的 IPv6 地址会还原为 IPv4）
• country（string|null）：国家，如 中国。国内 IP 与 ip-api 结果为中文；ip-api 不可用、仅有本地库结果的境外 IP 为英文（如 Australia）
• countryCode（string|null）：国家/地区代码（ISO 3166-1 两位字母），如 CN；香港、澳门、台湾分别为 HK、MO、TW
• region（string|null）：省/州，如 广东（去掉"省""市"后缀，直辖市为 北京）；未知时为 null
• city（string|null）：城市，如 深圳（去掉"市"后缀）；未知时为 null
• district（string|null）：区县；仅 ip-api 可能提供且多数情况下没有，此时为 null
• isp（string|null）：运营商/ISP 名称：本地库命中的国内 IP 为中文（如 中国电信、阿里），来自 ip-api 时多为英文（如 Chinanet）；未知时为 null
• org（string|null）：所属组织名称，如 Chinanet GD；仅 ip-api 提供，只查了本地库时为 null
• asn（string|null）：自治系统编号与名称，如 "AS4134 CHINANET-BACKBONE"；仅 ip-api 提供，只查了本地库时为 null
• lat（number|null）：大致纬度（十进制度，城市级精度，仅供参考）；仅 ip-api 提供，只查了本地库时为 null
• lon（number|null）：大致经度（十进制度，城市级精度，仅供参考）；仅 ip-api 提供，只查了本地库时为 null
• timezone（string|null）：所在时区（IANA 名称），如 Asia/Shanghai；本地库命中的中国大陆 IP 固定为 Asia/Shanghai，其他地区仅 ip-api 提供，未知时为 null
• location（string）：拼接好的归属地：国家、省、市、区县依次以空格连接，去掉空值和重复值，如 "中国 广东 深圳"
• source（string）：数据来源：ip2region（仅本地离线库）、ip-api（仅在线接口，如 IPv6 或本地库无记录）、ip2region+ip-api（本地结果由 ip-api 补全）