邮编查询

全国邮编查询,精确到县市.
接口编号: 507接口名称: 全国邮编查询连接应用: 1430个
应用编号: 131001应用标识: life.postcode服务商: NowAPI

说明

邮编查询接口api,提供全国邮政编码,精确到县/市,后续会陆续添加到乡镇.
可通过邮编查询地区名称、区号,也可通地区名称及地址查询邮编、区号。

例: https://sapi.k780.com/?app=life.postcode&postcode=528400&appkey=10003&sign=b59bc3ef6191eb9f747dd4e83c99f2a4&format=json
注意: 测试示例中appkey/sign我们会不定期调整,不建议在生产环境中使用。

调用方式

Get/Post

请求url

 HTTP: http://api.k780.com
HTTPS: https://sapi.k780.com

请求参数

参数 类型 是否必须 备注
postcode string 邮政编码 如528400 (与参数areaname二选一)
areaname string 区域名 如:广东省广州市 (与参数postcode二选一)
appkey string 使用API的唯一凭证 获取
sign string md5后的32位密文,登陆用. 获取
format {json|xml} 返回数据格式
jsoncallback string js跨域使用jsonp时可使用此参数

Json请求示例

http://api.k780.com/?app=life.postcode&postcode=528400&appkey=APPKEY&sign=SIGN&format=json

JsonP请求示例

http://api.k780.com/?app=life.postcode&postcode=528400&appkey=APPKEY&sign=SIGN&format=json&jsoncallback=data

Xml请求示例

http://api.k780.com/?app=life.postcode&postcode=528400&appkey=APPKEY&sign=SIGN&format=xml

Json返回示例

1.成功
{
    "success": "1",
    "result": {
        "count": "1",
        "lists": [
            {
                "areaid": "242",
                "postcode": "528400",
                "areacode": "0760",
                "areanm": "中华人民共和国,广东省,中山市",
                "simcall": "中国,广东,中山"
            }
        ]
    }
}

2.系统级别错误
{
    "success":"0",
    "msgid":"...",
    "msg":"..."
}

示例代码

<?php
header("Content-Type:text/html;charset=UTF-8");
function nowapiRequest($postData,&$errMsg=''){
    $apiUrl     = 'https://sapi.k780.com/';
    $useContext = stream_context_create(array(
        'http' => array(
            'method'  => 'POST',
            'header'  => 'Content-type:application/x-www-form-urlencoded',
            'content' => http_build_query($postData)
        )
    ));
    if(!$resData=file_get_contents($apiUrl,false,$useContext)){
        $errMsg = 'ERR_CONNECT';
        return false;
    }
    if(!$arrData=json_decode($resData,true)){
        $errMsg = 'ERR_DECODE';
        return false;
    }
    if($arrData['success']!=1){
        $errMsg = $arrData['msgid'].' '.$arrData['msg'];
        return false;
    }
    return $arrData['result'];
}

$postData['app'] = 'life.postcode';
$postData['postcode'] = '528400';
$postData['appkey'] = '10003';//替换成自己的appkey
$postData['sign'] = 'b59bc3ef6191eb9f747dd4e83c99f2a4';//替换成自己的sign
$postData['format'] = 'json';
$result = nowapiRequest($postData,$errMsg);
print_r($errMsg);
print_r($result);

#python
import json,urllib
from urllib import urlencode

url = 'http://api.k780.com'
params = {
  'app' : 'life.postcode',
  'postcode' : '528400',
  'appkey' : 'APPKEY',
  'sign' : 'SIGN',
  'format' : 'json',
}
params = urlencode(params)

f = urllib.urlopen('%s?%s' % (url, params))
nowapi_call = f.read()
#print content
a_result = json.loads(nowapi_call)
if a_result:
  if a_result['success'] != '0':
    print a_result['result'];
  else:
    print a_result['msgid']+' '+a_result['msg']
else:
  print 'Request nowapi fail.';

import java.net.*;
import java.io.*;

public class test{
    public static void main(String args[]) throws Exception {
        URL u=new URL("http://api.k780.com/?app=life.postcode&postcode=528400&appkey=APPKEY&sign=SIGN&format=json");
        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"));
    }
}

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title></title>
<script type="text/javascript" src="https://www.nowapi.com/style/jquery/1.11.3/jquery.min.js"></script>
<script>
$(document).ready(function(){
     $.ajax({
        type          : 'get',
        async         : false,
        url           : 'http://api.k780.com/?app=life.postcode&postcode=528400&appkey=APPKEY&sign=SIGN&format=json&jsoncallback=data',
        dataType      : 'jsonp',
        jsonp         : 'callback',
        jsonpCallback : 'data',
        success       : function(data){
            if(data.success!='1'){
                alert(data.msgid+' '+data.msg);
                exit;
            }
            //遍历
            var description = "";
            for(var i in data.result){
                var property=data.result[i];
                description+=i+" = "+property+"\n";
            }
            alert(description);
        },
        error:function(){
            alert('fail');
        }
    });
});
</script>
</head>
<body>
</body>
</html>

curl "http://api.k780.com/?app=life.postcode&postcode=528400&appkey=10003&sign=b59bc3ef6191eb9f747dd4e83c99f2a4&format=json"

流量包套餐说明:

买多少用多少,多买有优惠,10元起买,适合大多数应用场景.

规格套餐名称价格描述
201流量包 15000 次10 元-
202流量包 157500 次100 元含 7500 次赠送流量
203流量包 318000 次200 元含 18000 次赠送流量
204流量包 481500 次300 元含 31500 次赠送流量
205流量包 817500 次500 元含 67500 次赠送流量
206流量包 1650000 次1000 元含 150000 次赠送流量
207流量包 3330000 次2000 元含 330000 次赠送流量
208流量包 5040000 次3000 元含 540000 次赠送流量
209流量包 8625000 次5000 元含 1125000 次赠送流量
210流量包 18000000 次10000 元含 3000000 次赠送流量
立即开通

包月套餐说明:

适合调用量比较平均的高频应用场景;有配额限制,超出配额会被暂停调用1小时,请留意购买足够配额.

规格套餐名称价格描述
1011800 次配额/每小时48 元/月-
1023600 次配额/每小时87 元/月省¥ 9 享9.8折
1035400 次配额/每小时130 元/月省¥ 14 享9.5折
1049000 次配额/每小时218 元/月省¥ 22 享9折
10518000 次配额/每小时439 元/月省¥ 41 享8.5折
10636000 次配额/每小时883 元/月省¥ 77 享8折
10754000 次配额/每小时1332 元/月省¥ 108 享7.5折
10872000 次配额/每小时1786 元/月省¥ 134 享7折
10990000 次配额/每小时2244 元/月省¥ 156 享6.5折
110180000 次配额/每小时4800 元/月-
立即开通

免费试用套餐说明:

商用请选择付费套餐。 (系统繁忙或极端情况下,优先保证付费用户使用).

规格套餐名称价格描述
0试用套餐 100 次/每小时0 元/月可免费续约(现),试用次数不够可联系客服增加
立即开通

客户服务

客服QQ: 1486133340 
QQ群8: 204490433

客服微信:

数据定制

定制接口、定制数据格式、采集等;联系请提供数据样式范本。1486133340 

意见反馈