IP 定位 API

基于 IP 地址查询地理位置信息。

1. 接口基本信息

  • 接口名称：IP 位置信息查询
  • 接口地址：https://api.newayz.com/location/scenario/v1/ip/location
  • 请求方法：GET
  • 接口描述：通过传入 IP 地址和访问密钥，获取该 IP 对应的地理位置及相关信息。

2. 请求参数

参数名类型是否必填描述

参数名 类型 必填 描述
ip string 是 待查询的 IP 地址
access_key string 是 接口访问密钥（用于身份验证，需向服务提供商申请）

3. 响应参数

以下为常见 IP 定位接口的通用响应结构示例：

{
  "country": "中国",
  "province": "广东省",
  "city": "云浮市",
  "district": "",
  "center": "112.044524,22.915163",
  "reliability": "100|95|0"
}

4. 错误处理

错误码示例：当传入参数缺失或格式错误时，可能返回：

{
  "code": "401",
  "message": "No API key found in request"
}

5. 请求示例

https://api.newayz.com/location/scenario/v1/ip/location?ip={IP地址}&access_key={accessKEY}