IP地址定位 DEMO

查询 IPv4 或 IPv6 地址所属网络的地域资料

按现有 IP 归属资料返回地域和所属网络描述，不代表设备的实时或精确位置。Country 为历史地域描述字段，不是国家代码；Address 为来源网络或地域说明，IPv4 与 IPv6 的来源表达可能不同。LocationCode 为可关联的六位行政区划码，无可靠关联时为空字符串。未命中保留 Data 对象及原有空字段，DataTotalCount=0。资料覆盖和更新日期以实际库版本证据为准，不承诺每周更新。

业务说明

查询 IPv4 地址所属网络的地域资料。

查询 IPv6 地址所属网络的地域资料。

兼容合法 IPv6 压缩写法，便于处理网络记录。

保留 IPv4 映射 IPv6 地址的既有查询行为。

返回地域文字说明，便于展示网络归属参考。

返回来源提供的所属网络或补充地域说明。

返回可关联的六位行政区划码，便于地区资料整理。

无可靠行政区关联时保留空码，避免误填位置。

提供明确的未命中计数，便于处理库内未知地址。

可用于访问日志的地域资料补充和区域统计。

保留实际查询 IP 回显，便于逐条核对查询结果。

返回字段

字段	类型	必返	可为 null	说明
DataStatus.RequestParameter	string	是	否	本次真实、可读的业务请求参数，不含凭据；Demo 与实际示例输入对应。
DataStatus.StatusCode	integer	是	否	100 成功；501 参数错误对应 HTTP 400；901 处理或依赖失败对应 HTTP 503，公共鉴权和限流规则保持。
DataStatus.StatusDescription	string	是	否	业务处理结果说明。
DataStatus.ResponseDateTime	string	是	否	响应生成时间，不代表资料公布、行情交易或净值日期。
DataStatus.DataTotalCount	integer	是	否	本次实际返回记录数量；技术资讯为本页文章数，未命中归属资料时为 0。
Data	object	是	否	定位结果对象；未命中时保留对象并返回 DataTotalCount=0。
Data.Country	string / null	是	是	历史地域描述字段；不改为国家代码，未命中可为 null。
Data.Address	string / null	是	是	IP 地址具体定位地址
Data.LocationCode	string / null	是	是	可关联的六位行政区划码；无法关联时为空字符串，未命中可为 null。

业务状态与 HTTP 状态

业务码	含义	HTTP 与处理说明
100	请求成功	HTTP 200；请同时检查业务状态与返回数据。
501	参数错误	HTTP 400；参数缺失、类型错误或参数冲突。
502	请求频率限制	HTTP 429，沿用公共限流契约。
503	权益过期	HTTP 403，沿用公共权益契约。
504	凭据或权限错误	结合 HTTP 状态区分凭据缺失、无效、无商品权限或鉴权服务不可用。
505	调用额度不足	HTTP 403，沿用公共额度契约。
901	处理或依赖失败	HTTP 503；包含目标处理失败、依赖失败和超时。

接口详情：https://www.gugudata.com/api/details/iplocation
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

返回响应

🟢200成功

application/json

成功，业务码 100。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"ip=110.96.0.0","StatusCode":100,"StatusDescription":"请求成功。","ResponseDateTime":"2026-10-31 14:58:47.283","DataTotalCount":1},"Data":{"Address":"中移铁通","Country":"北京市","LocationCode":"110000"}}

🟠400参数缺失、非法、重复或冲突，业务码 501。

🔴503处理、依赖失败或超时，业务码 901。

业务说明#

返回字段#

业务状态与 HTTP 状态#

请求参数

请求示例代码

返回响应

业务说明

返回字段

业务状态与 HTTP 状态