获取IP地址归属信息接口

接口地址：http://localhost/public/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 | 表示服务端内部错误

本文档生成时间：2021-03-25 15:10:55