接口地址: https://api.gogoy.cn/api/ipinfo/

支持协议: HTTP/HTTPS

返回格式: JSON

请求方式: GET

请求示例: https://api.gogoy.cn/api/ipinfo/?ip=112.25.18.135

请求参数说明:

名称 必填 类型 说明
ip string 需要操作的IP,不传则默认为请求端的IP,支持jsonp

返回参数说明:

名称 类型 说明
res boolean 返回结果 true|false
code int 0为正常 其他为异常
msg string 提示信息
data array 返回的结果
country string 国家
province string 省份
city string 城市
isp string ISP服务商

返回示例:

{
	"res": true,
	"code": 0,
	"msg": "成功",
	"data": {
		"country": "中国",
		"province": "江苏",
		"city": "南京",
		"isp": "移动"
	},
	"timestamp": 1585041459
}

参数名称 参数值


{
	"res": true,
	"code": 0,
	"msg": "成功",
	"data": {
		"country": "中国",
		"province": "江苏",
		"city": "南京",
		"isp": "移动"
	},
	"timestamp": 1585041459
}

错误码格式说明:

名称 类型 说明
10000 string 缺少必填参数,请参考文档传递必填参数
10001 string 参数错误,请参考文档传递正确参数
10009 string 该api暂时停止服务
40004 string 非法请求
40001 string 请求频繁,请稍后再试!
40002 string 试用apiKey已达上限,如有需要请付费获取私有apiKey!

代码示例:

$ip = '112.25.18.135';
$api = 'https://api.gogoy.cn/api/ipinfo?ip=' . $ip;

$result = json_decode(file_get_contents($api), 1);

if (!empty($result['data']) && isset($result['data']['country'])) {
echo ' 国家: ' . $result['data']['country'];
echo ' 省份: ' . $result['data']['province'];
echo ' 城市: ' . $result['data']['city'];
echo ' isp: ' . $result['data']['isp'];
} else {
echo '获取失败:' . (empty($result['msg']) ? '未知错误' : $result['msg']);
}