国际邮编-地址查询

联系电话

400-000-0387

服务商

快递100

QQ客服

2850515744

服务时间

09:00-18:00

联系邮箱

api@kuaidi100.com

支持通过国际邮编查询对应的地区；或通过对应的国际地区查询邮编。支持日本、澳大利亚、意大利、马来西亚、泰国、西班牙、葡萄牙、瑞典、芬兰、奥地利、印度、德国、瑞士、加拿大、墨西哥、比利时、斯洛伐克、美国

¥ 原价：￥

套餐版本

0.00元/20次

120.00元/10000次

600.00元/50000次

1200.00元/100000次

1600.00元/200000次

4000.00元/500000次

有效时长

1年

联系电话

400-000-0387

服务商

快递100

QQ客服

2850515744

服务时间

09:00-18:00

联系邮箱

api@kuaidi100.com

API接口
产品详情
交付方式

邮编-地址查询
地址-邮编查询

调用地址： http://cloud.kuaidi100.com/api

请求方式： POST

返回类型： JSON

API 调用： API调用说明>>

调试工具： API调试>>

请求参数（Headers）

无参数

请求参数（Query）

无参数

请求参数（Body）

名称	类型	是否必须	描述
secret_key	string	true	用户授权key
secret_code	string	true	接口编号
secret_sign	string	true	加密签名：md5(secret_key+secret_secret)转大写
country	string	true	国家名称，如Thailand
postcode	string	true	邮政编码

请求示例

curl
Java
C#
PHP
Python

                        curl http://cloud.kuaidi100.com/api -X POST -d \
"secret_key=***&secret_code=e71b24e15d45431a8e541f628437efdd&secret_sign=md5(***)&country=&postcode="

                        import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.HashMap;
import java.util.Map;

public class CloudDemo {

    public static void main (String[] args) {
        CloudDemo cloudDemo = new CloudDemo();

        Map params = new HashMap();
        params.put("secret_key", "***");
        params.put("secret_code", "e71b24e15d45431a8e541f628437efdd");
        params.put("secret_sign", "md5(***)");
        params.put("country", "");
        params.put("postcode", "");

        cloudDemo.post(params);
    }

    public String post(Map params) {
        StringBuilder response = new StringBuilder("");
        BufferedReader reader = null;
        try {
            StringBuilder builder = new StringBuilder();
            for (Map.Entry param : params.entrySet()) {
                if (builder.length() > 0) {
                    builder.append('&');
                }
                builder.append(URLEncoder.encode(param.getKey(), "UTF-8"));
                builder.append('=');
                builder.append(URLEncoder.encode(String.valueOf(param.getValue()), "UTF-8"));
            }
            byte[] bytes = builder.toString().getBytes("UTF-8");
            URL url = new URL("http://cloud.kuaidi100.com/api");
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setConnectTimeout(5000);
            conn.setReadTimeout(5000);
            conn.setRequestMethod("POST");
            conn.setRequestProperty("accept", "*/*");
            conn.setRequestProperty("connection", "Keep-Alive");
            conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            conn.setRequestProperty("Content-Length", String.valueOf(bytes.length));
            conn.setDoOutput(true);
            conn.getOutputStream().write(bytes);
            reader = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"));
            String line = "";
            while ((line = reader.readLine()) != null) {
                response.append(line);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            try {
                if (null != reader) {
                    reader.close();
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        return response.toString();
    }
}

class MD5Utils {    private static MessageDigest mdigest = null;
    private static char digits[] = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'};
    private static MessageDigest getMdInst() {
        if (null == mdigest) {
            try {
                mdigest = MessageDigest.getInstance("MD5");
            } catch (NoSuchAlgorithmException e) {
                e.printStackTrace();
            }
        }
        return mdigest;
    }

    public static String encode(String s) {
        if(null == s) {
            return "";
        }

        try {            byte[] bytes = s.getBytes();
            getMdInst().update(bytes);
            byte[] md = getMdInst().digest();
            int j = md.length;
            char str[] = new char[j * 2];
            int k = 0;
            for(int i = 0; i < j; i++) {
                byte byte0 = md[i];
                str[k++] = digits[byte0 >>> 4 & 0xf];
                str[k++] = digits[byte0 & 0xf];
            }
            return new String(str);
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        }
    }
}

                        
                        暂无示例

                        <?php
    $params = "";
    $params .= 'secret_key=***'.'&';
    $params .= 'secret_code=e71b24e15d45431a8e541f628437efdd'.'&';
    $params .= 'secret_sign=md5(***)'.'&';
    $params .= 'country='.'&';
    $params .= 'postcode='.'&';
    $params .= substr($params, 0, -1);
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_URL, 'http://cloud.kuaidi100.com/api');
    curl_setopt($ch, CURLOPT_POSTFIELDS, $params);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    $result = curl_exec($ch);
    echo $result;
?>

                        # coding = utf-8
import sys,os
import requests,json,hashlib

params = {}
params['secret_key'] = '***'
params['secret_code'] = 'e71b24e15d45431a8e541f628437efdd'
params['secret_sign'] = 'md5(***)'
params['country'] = ''
params['postcode'] = ''
result = requests.post('http://cloud.kuaidi100.com/api', params)
print(result.text)

返回参数

无参数

正常返回示例

                    {
    "code": 200,
    "message": "success",
    "data": [
        {
            "recordId": "KoGKup2AHvEF",
            "postcode": "36526",
            "cn": "美国",
            "en": "United States",
            "state": "Alabama",
            "county": "Baldwin",
            "longitude": "-87.8895",
            "latitude": "30.6197",
            "city": "Daphne",
            "community": ""
        }
    ]
}

失败返回示例

                    {
    "code": -1,
    "message": "系统繁忙",
    "data": null
}

状态码定义

状态码	状态码信息	描述
-1	系统繁忙