IP地址
根据查询的IP地址或者域名,查询该IP所属的区域
基本说明:
接口地址:http://apis.juhe.cn/ip/ipNew
返回格式:json
请求方式:get/post
请求示例:http://apis.juhe.cn/ip/ipNew?ip=112.112.11.11&key=youkey
请求参数说明:
名称 类型 必填 说明
key string 必填 应用APPKEY,申请数据系统分配
ip string 必填 需要查询的IP地址
返回参数说明:
名称 类型 说明
error_code int 返回码
reason string 返回说明
result string 返回结果集
Country string 国家
Province string 省份区域,部分可能为空
City string 城市,部分可能为空
Isp string 运营商,部分可能为空
JSON返回示例:
{
	"resultcode": "200",
	"reason": "查询成功",
	"result": {
		"Country": "中国",
		"Province": "江苏省",
		"City": "无锡市",
		"Isp": "电信"
	},
	"error_code": 0
}
服务级错误码参照
错误码 说明
200101 ip地址不能为空
200102 错误的IP地址
200103 查询无结果
200104 要查询的地址不能为空
200105 查询无结果
10001 错误的请求KEY
10002 该KEY无请求权限
10003 KEY过期
10004 错误的OPENID
10005 应用未审核超时,请提交认证
10007 未知的请求源
10008 被禁止的IP
10009 被禁止的KEY
10011 当前IP请求超过限制
10012 请求超过次数限制
10013 测试KEY超过请求限制
10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失)
10020 接口维护
10021 接口停用
完整教学代码示例
<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2019/3/15 17:50
 */
//----------------------------------
// 聚合 根据IP查询地址 调用类
//----------------------------------
class freeApi{
    private $apiKey = false; //聚合appkey
    private $apiUrl = 'http://apis.juhe.cn/ip/ipNew';
    public function __construct($apikey){
        $this->apiKey = $apikey;
    }
    /**
     * 将JSON内容转为数据,并返回
     * @param string $content [内容]
     * @return array
     */
    public function returnArray($content){
        return json_decode($content,true);
    }
    /**
     * 获取 根据IP查询地址 结果
     * @return array
     */
    public function getResult(){
        $params = [
            "key" => $this->apiKey,//应用APPKEY(应用详细页查询)
            "ip" => "",//需要查询的IP地址或域名
        ];
        $params = http_build_query($params);
        return $this->returnArray($this->freeApiCurl($this->apiUrl,$params,1));
    }
    /**
     * 请求接口返回内容
     * @param  string $url [请求的URL地址]
     * @param  string $params [请求的参数]
     * @param  int $ipost [是否采用POST形式]
     * @return  string
     */
    public function freeApiCurl($url,$params=false,$ispost=0){
        $ch = curl_init();
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_USERAGENT , 'free-api' );
        curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT , 60 );
        curl_setopt( $ch, CURLOPT_TIMEOUT , 60);
        curl_setopt( $ch, CURLOPT_RETURNTRANSFER , true );
        if( $ispost )
        {
            curl_setopt( $ch , CURLOPT_POST , true );
            curl_setopt( $ch , CURLOPT_POSTFIELDS , $params );
            curl_setopt( $ch , CURLOPT_URL , $url );
        }
        else
        {
            if($params){
                curl_setopt( $ch , CURLOPT_URL , $url.'?'.$params );
            }else{
                curl_setopt( $ch , CURLOPT_URL , $url);
            }
        }
        $response = curl_exec( $ch );
        if ($response === FALSE) {
            return false;
        }
        curl_close( $ch );
        return $response;
    }
}