IP归属地查询接口

IP地址归属地API

全球IP地址归属地信息查询 国家 省 市 区 运营商

查看阶梯报价

注册登录可获取免费IP地址归属地数据接口查询点数

V1版本接口已停用
V1.1版本在V1的基础上修改增加了GET提交 API接入相比V1版本更简单
V2版本不直接明文POST提交APIKEY,使用SHA256算法提交sign参数 具体请参考对接文档及示例代码
鉴于 IP 地址地理映射技术的复杂性和互联网基础设施的多变性,该IP数据存在以下固有限制。
精度限制:IP数据中所提供的地理位置信息(包括但不限于国家、省份、城市、区县)的精度取决于 IP 地址段的特性及数据来源,不担保对每一特定 IP 地址都能达到所描述的最高粒度级别(如精确到区县)。
坐标说明:IP数据提供的 “坐标” 并非代表该 IP 地址下用户设备的实时精确地理位置,而是该 IP 地址段所映射的行政区域或网络节点的中心点或常用参考点,仅供参考。
运营商信息:“运营商” 信息基于网络探测和数据关联分析获得,仅代表该 IP 地址段在数据采集时刻的注册归属或常用运营商信息。该信息可能因 IP 地址动态分配、运营商策略调整、网络重编号等原因与实际当前使用者不一致。
实时性:IP数据库每月更新一次,无法实时反映IP地址归属的瞬时变化

1: 接口提交URL 提交方式

URL: https://gsdapi.com/api/v1.1/Ip?key=******&ip=*******
提交方式: GET

2: 传递参数:ip、key

ip: Ipv4格式的IP地址
key: 系统分配用户的APIkey值

3:返回数据字段说明

RESULT: 返回码 1查询成功 -1异常错误
MESSAGE: 返回码说明
Country: ip所属国家(如果没有查询结果为null)
Province: ip所属省份(如果没有查询结果为null)
City: ip所属城市(如果没有查询结果为null)
Area: ip所属县区(如果没有查询结果为null)
Isp: ip所属电信运营商

4:示例

URL: https://gsdapi.com/api/v1.1/Ip?key=5021eb********3c798a63fb&ip=14.127.123.1

5:返回json

{"RESULT":"1","MESSAGE":"查询成功","Country":"中国","Province":"广东省","City":"深圳市","Area":"龙岗区","Isp":"中国电信"}

sign加密码方法

加密使用了SHA256算法
加密字符串为:用户ID(uid)+当前时间(time)+用户KEY(APIkey) 连接拼成的长字符串
示例:uid=1000012345
time=20211208101858(注:2021-12-08 10:18:58 去掉时间当中的- :)
apikey=145b9c7f6aa67377bb664521007079a9
拼接后的字符串uid+time+apikey:100001234520211208101858145b9c7f6aa67377bb664521007079a9
sha256加密后字符:67bec755ce5704222a4ece083493dd3d54686281f4a80b83e1de277b860f34a3

1: 接口提交URL 提交方式

URL: https://gsdapi.com/api/v2/Ip
提交方式: POST

2: 传递参数:uid、time、sign、ip

uid: 系统分配的用户ID
time: 当前提交接口查询的时间(年月日时分秒)
sign: sign加密字符串(详见sign加密方法)
ip: Ipv4格式的IP地址

3:返回数据字段说明

RESULT: 返回码 1查询成功 0查无记录 -1异常错误
MESSAGE: 返回码说明
Country: ip所属国家(如果没有查询结果为null)
Province: ip所属省份(如果没有查询结果为null)
City: ip所属城市(如果没有查询结果为null)
Area: ip所属县区(如果没有查询结果为null)
Isp: ip所属电信运营商

4:示例

URL: https://gsdapi.com/api/v2/Ip
POST参数
uid=1000012345
time=20211208101858(注:2021-12-08 10:18:58 当前查询时间去掉时间当中的- :)
sign=67bec755ce5704222a4ece083493dd3d54686281f4a80b83e1de277b860f34a3
ip=14.127.123.1 (Ipv4格式的IP地址)
以上参数POST form-data是数组

5:返回json

{"RESULT":"1","MESSAGE":"查询成功","Country":"中国","Province":"广东省","City":"深圳市","Area":"龙岗区","Isp":"中国电信"}

V1.1版本 php curl 示例代码

替换以下代码中的ip、key 值即可

V2版本 php curl 示例代码

替换以下代码中的ip、uid、time、sign 值即可