[DEMO] 国际 IP 地址定位

定位结果是 IP 所属网络的地域参考，不代表设备实时位置。城市、省份可能为空；经纬度为可用定位记录中的数值，缺失或冲突记录明确失败。数据公布与更新频率以实际来源为准。

当前接口契约

公开 Demo 用于查看调用方式和响应结构，返回范围以示例参数为准。

正常响应

HTTP 200，application/json。

字段	类型	说明
dataStatus	object
dataStatus.requestParameter	string	真实、可读的业务请求参数；无业务参数时为空，不包含凭据。
dataStatus.statusCode	integer	接口返回状态码
dataStatus.status	string	接口返回状态，例如 SUCCESS 或 ERROR。
dataStatus.statusDescription	string	接口返回状态说明
dataStatus.responseDateTime	string	接口数据返回时间
dataStatus.dataTotalCount	integer
data	object

业务状态说明

业务状态码	业务状态码解释	备注
400	参数错误	HTTP 400
500	定位数据不可用	HTTP 500

返回响应

🟢200成功

application/json

成功，业务码 200。

Bodyapplication/json

示例

{"dataStatus":{"requestParameter":"ip=2001:4878:b554:aaaa:aaaa:aaaa:aaaa:aaaa","statusCode":200,"status":"SUCCESS","statusDescription":"successfully / 成功","responseDateTime":"2026-10-26 19:20:51","dataTotalCount":1},"data":{"countryCode":"US","state":"Massachusetts","city":"Cambridge (East Cambridge)","latitude":42.3649,"longitude":-71.0889}}

🟠400参数错误，业务码 400。

🔴500定位数据不可用，业务码 500。

当前接口契约#

正常响应#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

正常响应

业务状态说明