<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$zipcode = '310012';
$url = "https://api.jisuapi.com/zipcode/query?appkey=$appkey&zipcode=$zipcode";
$result = curlOpen($url, ['ssl'=>true]);

$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
foreach($result as $val)
{
    echo $val['province'].' '.$val['city'].' '.$val['town'].' '.$val['address'].' '.$val['zipcode'].'
';
}

#!/usr/bin/python
# encoding:utf-8

import requests

#  1、邮编查地址

data = {}
data["appkey"] = "your_appkey_here"
data["zipcode"] = "310012"

url = "https://api.jisuapi.com/zipcode/query"
response = requests.get(url,params=data)
jsonarr = response.json()
if jsonarr["status"] != 0:
    print(jsonarr["msg"])
    exit()
result = jsonarr["result"]
for val in result:
    print(val["province"],val["city"],val["town"],val["address"],val["zipcode"])


#  2、地址查邮编

data = {}
data["appkey"] = "your_appkey_here"
data["adress"] = "杭州师范大学"
data["areaid"] = 382

url = "https://api.jisuapi.com/zipcode/addr2code"
response = requests.get(url,params=data)
jsonarr = response.json()
if jsonarr["status"] != 0:
    print(jsonarr["msg"])
    exit()
result = jsonarr["result"]
for val in result:
    print(val["province"],val["city"],val["town"],val["address"],val["zipcode"])

package api.jisuapi.zipcode;

import api.util.HttpUtil;
import net.sf.json.JSONArray;
import net.sf.json.JSONObject;

public class Query {

	public static final String APPKEY = "your_appkey_here";// 你的appkey
	public static final String URL = "https://api.jisuapi.com/zipcode/query";
	public static final String zipcode = "310012";

	public static void Get() {
		String result = null;
		String url = URL + "?appkey=" + APPKEY + "&zipcode=" + zipcode;

		try {
			result = HttpUtil.sendGet(url, "utf-8");
			JSONObject json = JSONObject.fromObject(result);
			if (json.getInt("status") != 0) {
				System.out.println(json.getString("msg"));
			} else {
				JSONArray resultarr = json.optJSONArray("result");
				for (int i = 0; i < resultarr.size(); i++) {
					JSONObject obj = (JSONObject) resultarr.opt(i);
					String province = obj.getString("province");
					String city = obj.getString("city");
					String town = obj.getString("town");
					String address = obj.getString("address");
					String zipcode = obj.getString("zipcode");
					System.out.println(province + " " + city + " " + town + " " + address + " " + zipcode);
				}
			}
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

JSON返回示例 :

{
    "status": 0,
    "msg": "ok",
    "result": [
        {
            "province": "浙江省",
            "city": "杭州市",
            "town": "西湖区",
            "address": "文一路80号浙江省省委党校图书馆(杂志)",
            "zipcode": "310012"
        },
        {
            "province": "浙江省",
            "city": "杭州市",
            "town": "西湖区",
            "address": "余杭塘路388号浙江医科大学图书馆(杂志)",
            "zipcode": "310012"
        },
        {
            "province": "浙江省",
            "city": "杭州市",
            "town": "西湖区",
            "address": "文二路125号浙江幼儿师范学校图书馆(杂志)",
            "zipcode": "310012"
        }
    ]
}

接口地址： https://api.jisuapi.com/zipcode/addr2code

返回格式： JSON

请求方法： GET POST

请求示例： https://api.jisuapi.com/zipcode/addr2code?appkey=yourappkey&address=杭州师范大学&areaid=382

请求参数：

在线测试

参数名称	类型	必填	说明
address	string	是	地址
areaid	int	是	区域ID

返回参数：

参数名称	类型	说明
province	string	省
city	string	市
town	string	县
address	string	地址
zipcode	string	邮编

请求代码：

查看代码

PHP
Java

<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$address = '杭州师范大学';//utf8
$areaid = 382;
$url = "https://api.jisuapi.com/zipcode/addr2code?appkey=$appkey&address=$address&areaid=$areaid";
$result = curlOpen($url, ['ssl'=>true]);
$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
foreach($result as $val)
{
    echo $val['province'].' '.$val['city'].' '.$val['town'].' '.$val['address'].' '.$val['zipcode'].'
';
}

package api.jisuapi.zipcode;

import java.net.URLEncoder;

import api.util.HttpUtil;
import net.sf.json.JSONArray;
import net.sf.json.JSONObject;

public class Addr2code {

	public static final String APPKEY = "your_appkey_here";// 你的appkey
	public static final String URL = "https://api.jisuapi.com/zipcode/addr2code";
	public static final String zipcode = "310012";
	public static final String address = "杭州师范大学";// utf-8
	public static final int areaid = 382;

	public static void Get() throws Exception {
		String result = null;
		String url = URL + "?appkey=" + APPKEY + "&zipcode=" + zipcode + "&address="
				+ URLEncoder.encode(address, "utf-8") + "&areaid=" + areaid;

		try {
			result = HttpUtil.sendGet(url, "utf-8");
			JSONObject json = JSONObject.fromObject(result);
			if (json.getInt("status") != 0) {
				System.out.println(json.getString("msg"));
			} else {
				JSONArray resultarr = json.optJSONArray("result");
				for (int i = 0; i < resultarr.size(); i++) {
					JSONObject obj = (JSONObject) resultarr.opt(i);
					String province = obj.getString("province");
					String city = obj.getString("city");
					String town = obj.getString("town");
					String address = obj.getString("address");
					String zipcode = obj.getString("zipcode");
					System.out.println(province + " " + city + " " + town + " " + address + " " + zipcode);
				}
			}
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

JSON返回示例 :

{
    "status": 0,
    "msg": "ok",
    "result": [
        {
            "province": "浙江省",
            "city": "杭州市",
            "town": "西湖区",
            "address": "文一路222号杭州师范学院钱江学院精品图书馆(杂志)",
            "zipcode": "310012"
        },
        {
            "province": "浙江省",
            "city": "杭州市",
            "town": "西湖区",
            "address": "玉皇山路77号杭州师范学校",
            "zipcode": "310002"
        },
        {
            "province": "浙江省",
            "city": "杭州市",
            "town": "西湖区",
            "address": "文一路222号杭州师范学院",
            "zipcode": "310012"
        }
    ]
}

接口地址： https://api.jisuapi.com/zipcode/area

返回格式： JSON

请求方法： GET

请求示例： https://api.jisuapi.com/zipcode/area?appkey=yourappkey

请求参数：

在线测试

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明
areaid	int	区域ID
name	string	区域名称
parentid	int	上级ID

请求代码：

查看代码

<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$url = "https://api.jisuapi.com/zipcode/area?appkey=$appkey";
$result = curlOpen($url, ['ssl'=>true]);
$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
foreach($result as $val)
{
    echo $val['areaid'].' '.$val['name'].' '.$val['parentid'].'
';
}

#!/usr/bin/python
# encoding:utf-8

import requests
	
data = {}
data["appkey"] = "your_appkey_here"

url = "https://api.jisuapi.com/zipcode/area"
response = requests.get(url,params=data)
jsonarr = response.json()
if jsonarr["status"] != 0:
    print(jsonarr["msg"])
    exit()
result = jsonarr["result"]
for val in result:
	print(val["areaid"],val["name"],val["parentid"])

package api.jisuapi.zipcode;

import api.util.HttpUtil;
import net.sf.json.JSONArray;
import net.sf.json.JSONObject;

public class Area {

	public static final String APPKEY = "your_appkey_here";// 你的appkey
	public static final String URL = "https://api.jisuapi.com/zipcode/area";

	public static void Get() {
		String result = null;
		String url = URL + "?appkey=" + APPKEY;

		try {
			result = HttpUtil.sendGet(url, "utf-8");
			JSONObject json = JSONObject.fromObject(result);
			if (json.getInt("status") != 0) {
				System.out.println(json.getString("msg"));
			} else {
				JSONArray resultarr = json.optJSONArray("result");
				for (int i = 0; i < resultarr.size(); i++) {
					JSONObject obj = (JSONObject) resultarr.opt(i);
					String areaid = obj.getString("areaid");
					String name = obj.getString("name");
					String parentid = obj.getString("parentid");
					System.out.println(areaid + " " + name + " " + parentid);
				}
			}
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

JSON返回示例 :

{
    "status": 0,
    "msg": "ok",
    "result": [
        {
            "areaid": "1",
            "name": "北京",
            "parentid": "0"
        },
        {
            "areaid": "2",
            "name": "安徽",
            "parentid": "0"
        },
        {
            "areaid": "3",
            "name": "福建",
            "parentid": "0"
        }
    ]
}

API错误码：

代号	说明
201	邮编为空
202	邮编不正确
203	区域和地址都为空
204	没有信息

系统错误码：

代号	说明
101	APPKEY为空或不存在
102	APPKEY已过期
103	APPKEY无请求此数据权限
104	请求超过次数限制
105	IP被禁止
106	IP请求超过限制
107	接口维护中
108	接口已停用