ShowAPI,自营为主的数据交易市场
立即注册

邮政编码查询

提供者: huisousuo 免费使用

邮政编码查询 按邮政编码查询 按地址查询

浏览量:3554

调用量:1676

使用人数:29

点赞:3

申请使用 查看演示
文档 授权签名(重要) 联系信息 价格一览表 接口演示
接入点列表
按地址查询邮政编码
按邮政编码查询地址
资源列表
·SDK及代码示例
规则中心
·名词解释
·常见问题
·用户留言

请求URL地址

http://route.showapi.com/1151-2
注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。

请求参数

HTTP协议,支持GET/POST方法。
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1.系统级参数(所有接入点都需要的参数):+点此展开
2.应用级参数(每个接入点有自己的参数):
参数名称 类型 默认值 示例值 必须 描述
province String NULL 江苏
city String NULL 南京
district String NULL 江宁
address String NULL 将军大道 地址详情
page String 1 2 请填写参数描述

返回参数

以JSON格式返回结果。
1.系统级参数(所有接入点都会返回的参数):+点此展开
2.应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
名称 类型 示例值 描述
error_code String 00 错误代码
error_description String 查询成功 错误描述
page String 1 页码
page_max String 90 最大页码
count String 895 记录数
provinceid String 15 省ID
province String 江苏
cityid String 167 市ID
city String 南京
districtid String 380 区ID
district String 江宁
address String 将军大道 地址参数
addr String 江苏省南京市江宁区 陆郎镇府东巷 查询地址
zip String 211163 请填写参数描述
  • 请求实例
  • java_sdk
  • 纯java
  • curl
  • php
  • android
  • python
String res=new ShowApiRequest("http://route.showapi.com/1151-2","my_appId","my_appSecret")
           .addTextPara("province","江苏")
           .addTextPara("city","南京")
           .addTextPara("district","江宁")
           .addTextPara("address","将军大道")
           .addTextPara("page","2")
           .post();
System.out.println(res);

                  public static void main(String path[]) throws Exception {
									URL u=new URL("http://route.showapi.com/1151-2?showapi_appid=myappid&province=&city=&district=&address=&page=&showapi_sign=mysecret");
									InputStream in=u.openStream();
									ByteArrayOutputStream out=new ByteArrayOutputStream();
									try {
										byte buf[]=new byte[1024];
										int read = 0;
										while ((read = in.read(buf)) > 0) {
											out.write(buf, 0, read);
										}
									}  finally {
										if (in != null) {
											in.close();
										}
									}
									byte b[]=out.toByteArray( );
									System.out.println(new String(b,"utf-8"));
							}
						 
						
						//字段值为中文、空格、特殊符号的地方需要做urlencode,编码为utf-8。用js的方式就是:
						//encodeURIComponent('中文')
						//比如"中文"转换后就是%25E4%25B8%25AD%25E6%2596%2587
            curl   "http://route.showapi.com/1151-2?showapi_appid=123&showapi_timestamp=20151214132239&showapi_sign=use_my_sign&province=江苏&city=南京&district=江宁&address=将军大道&page=2&"
						
						 //md5签名方式--非简单签名
               			<?php
							header("Content-Type:text/html;charset=UTF-8");
							date_default_timezone_set("PRC");
							$showapi_appid = 'xxxxxx';  //替换此值,在官网的"我的应用"中找到相关值
							$showapi_secret = 'xxxxxxxxx';  //替换此值,在官网的"我的应用"中找到相关值 
							$paramArr = array(
							     'showapi_appid'=> $showapi_appid,
								 'province'=> "",
								 'city'=> "",
								 'district'=> "",
								 'address'=> "",
								 'page'=> ""
							     //添加其他参数
							);
							
							//创建参数(包括签名的处理)
							function createParam ($paramArr,$showapi_secret) {
							     $paraStr = "";
							     $signStr = "";
							     ksort($paramArr);
							     foreach ($paramArr as $key => $val) {
							         if ($key != '' && $val != '') {
							             $signStr .= $key.$val;
							             $paraStr .= $key.'='.urlencode($val).'&';
							         }
							     }
							     $signStr .= $showapi_secret;//排好序的参数加上secret,进行md5
							     $sign = strtolower(md5($signStr));
							     $paraStr .= 'showapi_sign='.$sign;//将md5后的值作为参数,便于服务器的效验
							     echo "排好序的参数:".$signStr."
\r\n"; return $paraStr; } $param = createParam($paramArr,$showapi_secret); $url = 'http://route.showapi.com/1151-2?'.$param; echo "请求的url:".$url."
\r\n"; $result = file_get_contents($url); echo "返回的json数据:
\r\n"; print $result.'
\r\n'; $result = json_decode($result); echo "
\r\n取出showapi_res_code的值:
\r\n"; print_r($result->showapi_res_code); echo "
\r\n"; ?>
						//以下代码为纯java实现,并未依赖第三方框架,具体传入参数请参看接口描述详情页.
						protected Handler mHandler =  new Handler();
						protected void onCreate(Bundle savedInstanceState) {
								super.onCreate(savedInstanceState);
								setContentView(R.layout.activity_main);
								final TextView txt = (TextView) this.findViewById(R.id.textView1);
								Button myBtn = (Button) this.findViewById(R.id.button1);
								myBtn.setOnClickListener(new OnClickListener() {
									public void onClick(View v) {
										new Thread(){
											//在新线程中发送网络请求
											public void run() {
												String appid="xxx";//要替换成自己的
												String secret="xxxxxxx";//要替换成自己的
												final String res=new ShowApiRequest( "http://route.showapi.com/1151-2", appid, secret)
                    .addTextPara("province", "")
                                .addTextPara("city", "")
                                .addTextPara("district", "")
                                .addTextPara("address", "")
                                .addTextPara("page", "")
            .post();
												
												System.out.println(res);
												//把返回内容通过handler对象更新到界面
												mHandler.post(new Thread(){
													public void run() {
														txt.setText(res+"  "+new Date());
													}
												});
											}
										}.start();
										
										
									}
								});
						}

						
#phthon3.5
from urllib import    request, parse
import json

print('send data....')
showapi_appid="xxxxxxxxxx"  #替换此值
showapi_sign="xxxxxxxxxx"   #替换此值
url="http://route.showapi.com/1151-2"
send_data = parse.urlencode([
    ('showapi_appid', showapi_appid)
    ,('showapi_sign', showapi_sign)
                    ,('province', "")
                    ,('city', "")
                    ,('district', "")
                    ,('address', "")
                    ,('page', "")
    
  ])

req = request.Request(url) 
with request.urlopen(req, data=send_data.encode('utf-8')) as f:
    print('Status:', f.status, f.reason)
    str_res= f.read().decode('utf-8')
    print('str_res:',str_res)
    json_res=json.dumps(str_res)
    print ('json_res data is:', json_res)

    
						 

						

返回实例

{
	"showapi_res_code": 0,
	"showapi_res_error": "",
	"showapi_res_body": {
		"error_code": "00",
		"error_description": "查询成功",
		"page": "1",
		"page_max": "90",
		"count": "895",
		"provinceid": "15",
		"province": "江苏",
		"cityid": "167",
		"city": "南京",
		"districtid": "380",
		"district": "江宁",
		"address": "将军大道",
		"addr": "江苏省南京市江宁区 陆郎镇府东巷",
		"zip": "211163"
	}
}




请求地址 请求参数 返回参数 请求示例 返回示例
接入点列表
按地址查询邮政编码
按邮政编码查询地址
  • 免费套餐(按地址查询邮政编码)

免费套餐_无认证版

0时间:1年

  • 30次每天
  • 1次/秒调用频率
  •  
  •  
点此订购

免费套餐_基本认证版

0时间:1年

  • 30次每天
  • 2次/秒调用频率
  • 邮箱认证 要求
  • 手机认证 要求
点此订购

免费套餐_实名认证版

0时间:1年

  • 50次每天
  • 3次/秒调用频率
  • 邮箱认证 要求
  • 手机认证 要求
  • 实名认证 要求
点此订购