IP查询专业版：支持IPv4/IPv6自动识别并切换解析的API接口使用指南

一、API概述

在开发过程中，我们常常需要对IP地址进行查询，以获取其详细信息，如地理位置、运营商等。万维易源的“IP查询专业版”API接口能够提供丰富的IP查询功能，帮助开发者快速获取所需数据。本文将详细介绍如何使用这个API接口。

1、接入点说明（以“ipv4”为例）

• 查询成功且返回有效数据：扣除1个查询额度。
• 查询成功但未返回有效数据：每10次扣除1个查询额度。
• 经过对国内外IP查询结果的长期统计，查询成功时约有70%的查询是不扣查询额度的。
• 返回有效数据：指返回精度达到街道级别的数据。

2、接口地址

https://route.showapi.com/2653-1?appKey={your_appKey}

请将 {your_appKey} 替换为你在万维易源平台申请的个人 appKey。

二、请求参数说明

以下是提交ip字段信息查询任务所需的请求参数：

参数名称	类型	示例值	必须	描述
ip	String	121.41.117.26	是	要查询的IP，暂时只能查IPv4

三、返回参数

以下是接口返回的参数及其描述：

参数名称	类型	示例值	描述
remark	String		错误信息
isp	String	中国电信	运营商
accuracy	String	街道	精度
correctness	Number	5	准确度
ret_code	Number	0	0表示查询成功要扣费，1表示查询成功但不扣费，-1表示查询失败
owner	String	中国电信	所属机构
source	String	地面采集	采集方式
consistency	Number	4	一致性
multiAreas	Object[]		定位区域
- radius	String	2.1048	半径（公里）
- lat	String	25.053371	定位坐标纬度
- city	String	昆明市	城市
- address	String		街道地址
- district	String	五华区	区县
- prov	String	云南省	省
- lng	String	102.684575	定位坐标经度
- areaCode	String	330100	该定位点的国内行政区划代码（目前只有中国大陆地区IP有该字段返回）
areacode	String	CN	国家编码
timezone	String	UTC+8	时区
country	String	中国	国家
continent	String	亚洲	大洲
asnumber	String	4134	自治域编码
zipcode	String	650021	邮编

四、调用示例

以下是使用curl命令调用该API接口的示例：

curl \
  -X POST 'https://route.showapi.com/2653-1?appKey=your_appKey&ip=121.41.117.26' \
  -H 'Content-Type: application/x-www-form-urlencoded'

请将 your_appKey 替换为你在万维易源平台申请的 appKey。

五、返回示例

调用成功后，接口会返回如下格式的JSON数据：

{
  "showapi_res_id": "",
  "showapi_res_error": "",
  "showapi_res_code": 0,
  "showapi_res_body": {
    "remark": "",
    "isp": "中国电信",
    "accuracy": "街道",
    "correctness": 5,
    "ret_code": 0,
    "owner": "中国电信",
    "source": "地面采集",
    "consistency": 4,
    "multiAreas": [
      {
        "radius": "2.1048",
        "lat": "25.053371",
        "city": "昆明市",
        "address": "",
        "district": "五华区",
        "prov": "云南省",
        "lng": "102.684575"
      }
    ],
    "areacode": "CN",
    "timezone": "UTC+8",
    "country": "中国",
    "continent": "亚洲",
    "asnumber": "4134",
    "zipcode": "650021"
  }
}

六、注意事项

1. 获取AppKey：在调用接口之前，需要先在万维易源官网注册并获取你的appKey。
2. IP限制：目前该接口只支持IPv4地址的查询。
3. 频率限制：请注意接口的调用频率限制，避免因频繁调用导致服务不可用。
4. 数据精度：返回的有效数据精度可能因IP地址的不同而有所差异，建议根据实际需求进行测试。

七、总结

万维易源的“IP查询专业版”API接口为开发者提供了一个高效、便捷的工具，能够快速获取IP地址的详细信息。通过简单的参数配置和调用，即可实现复杂的数据查询任务，大大提高了开发效率。希望本文的介绍对你有所帮助，如果你有任何疑问或需要进一步的帮助，请随时访问万维易源的官方文档或联系技术支持。