全国邮编查询
聚合数据 官方文档
提供全国邮政编码大全,为你快速准确查邮编
基本说明:
接口地址:http://v.juhe.cn/postcode/query
返回格式:json/xml
请求方式:get/post
请求示例:http://v.juhe.cn/postcode/query?postcode=215001&key=申请的KEY
请求参数说明:
名称 类型 必填 说明
key string 必填 应用APPKEY,申请数据系统分配
postcode string 必填 邮编,如:215001
page int 选填 页数,默认1
pagesize int 选填 每页返回,默认:20,最大不超过50
dtype string 选填 返回数据的格式,xml或json,默认json
返回参数说明:
名称 类型 说明
error_code int 返回码
reason string 返回说明
JSON返回示例:
{
	"reason": "successed",
	"result": {
		"list": [{
				"PostNumber": "215001",
				"Province": "江苏省",
				"City": "苏州市",
				"District": "平江区",
				"Address": "廖家巷新光里"
			},
			{
				"PostNumber": "215001",
				"Province": "江苏省",
				"City": "苏州市",
				"District": "平江区",
				"Address": "龙兴桥顺德里"
			}
		],
		"totalcount": 352,
		"totalpage": 176,
		"currentpage": 1,
		"pagesize": "2"
	},
	"error_code": 0
}
服务级错误码参照
错误码 说明
206601 错误的邮编号码
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
 */
//----------------------------------
// 聚合 邮编查询地名 调用类
//----------------------------------
class freeApi{
    private $apiKey = false; //聚合appkey
    private $apiUrl = 'http://v.juhe.cn/postcode/query';
    public function __construct($apikey){
        $this->apiKey = $apikey;
    }
    /**
     * 将JSON内容转为数据,并返回
     * @param string $content [内容]
     * @return array
     */
    public function returnArray($content){
        return json_decode($content,true);
    }
    /**
     * 获取 邮编查询地名 结果
     * @return array
     */
    public function getResult(){
        $params = [
            "postcode" => "",//邮编,如:215001
            "key" => $this->apiKey,//应用APPKEY(应用详细页查询)
            "page" => "",//页数,默认1
            "pagesize" => "",//每页返回,默认:20,最大不超过50
            "dtype" => "",//返回数据的格式,xml或json,默认json
        ];
        $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;
    }
}