获取IP地址归属信息接口 - App.IP.GetInfo - EagletAPI

接口地址：http://api.kittyhawks.cn/api/app.php?s=App.IP.GetInfo

接口描述：根据IP地址获取归属信息，定位用户所在城市

HTTP/HTTPS

请求协议

GET/POST

请求方式

UTF-8

编码格式

JSON

返回格式

接口参数

参数名字	类型	是否必须	默认值	其他	说明
access_token	字符串	可选			访问令牌，仅当开启签名验证时需要传递，生成令牌可使用App.Auth.ApplyToken接口
ip	字符串	可选	-		IP地址，不传时自动取客户端IP地址，示例：192.168.0.1

返回字段

返回结果	类型	说明
ret	整型	状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务器错误
data	对象或混合类型	业务数据，由各自接口指定，通常为对象
data.info	对象	IP信息，没有时为null
data.info.ip	字符串	当前IP地址
data.info.country	字符串	Ip地址的所在国家
data.info.province	字符串	Ip地址的所在地区
data.info.city	字符串	Ip地址的所在城市
data.info.isp	字符串	Ip地址的所在服务商
data.info.area	字符串	所在地址
msg	字符串	提示信息，失败时的错误提示

在线测试

参数	是否必须	值
service	必须
access_token	可选
ip	可选

客户端请求示例

{
    "ret": 200,
    "data": {
        "info": {
            "ip": "61.147.110.191",
            "country": "中国",
            "province": "江苏",
            "city": "扬州市",
            "county": "",
            "isp": "电信",
            "area": "中国江苏扬州市IDC机房"
        }
    },
    "msg": ""
}

错误列表

错误状态码	错误描述信息
400	表示客户端参数错误
404	表示接口服务不存在
500	表示服务端内部错误

本文档生成时间：2024-11-21 23:45:53