当前位置：首页 > news >正文

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

news 2025/4/29 18:26:08

一、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"}
}