快速获取快递网点位置、电话信息,判断某快递是否可以到达某地,用于网点布局参考。
无参数
无参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
secret_key | string | true | 用户授权key |
secret_code | string | true | 接口编号 |
secret_sign | string | true | 加密签名:md5(secret_key+secret_secret)转大写 |
method | string | true | 默认参数:searchnetwork |
param | string | false | param示例为:{"area":"广东-深圳市-福田区","keyword":"赛格(选填)","company":"shentong(选填)","offset":"0(页数0开始)"} |
curl http://cloud.kuaidi100.com/api -X POST -d \
"secret_key=***&secret_code=d9dc91cb9d124dc897a0674528b59dab&secret_sign=md5(***)&method=¶m="
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", "d9dc91cb9d124dc897a0674528b59dab");
params.put("secret_sign", "md5(***)");
params.put("method", "");
params.put("param", "");
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=d9dc91cb9d124dc897a0674528b59dab'.'&';
$params .= 'secret_sign=md5(***)'.'&';
$params .= 'method='.'&';
$params .= 'param='.'&';
$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'] = 'd9dc91cb9d124dc897a0674528b59dab'
params['secret_sign'] = 'md5(***)'
params['method'] = ''
params['param'] = ''
result = requests.post('http://cloud.kuaidi100.com/api', params)
print(result.text)
无参数
{
"status": 200,
"message": "成功",
"netList": [
{
"id": 7950922429974716,
"sId": "7950922429974716",
"md5Code": "3CF63F8CEA06DC6B5F3E8C9A9AB80174",
"companyId": 4,
"companyNumber": "yuantong", //公司编码
"companyName": "圆通快递", //公司名
"number": "上海市虹口区江湾", //编码
"name": "上海市虹口区江湾", //名称
"linkman": null, //联系人
"address": "上海,上海市,虹口区", //地址
"workArea": "全境", //派件区域
"refuseArea": "无", //不派件区域
"xzqNumber": "310909000000", //默认行政区编码
"xzqFullName": "上海,虹口区,虹口区", //默认行政区全称
"longitude": 0, //经度
"latitude": 0, //纬度
"tel": "虹口区江湾查询电话:021-35070256 021-65256173;客服电话:021-35070256 021-65256173;取件电话:021-65869074;投诉电话:021-65285319...",
"mobile": null,
"fax": "021-65285312",
"qq": null,
"remark": "-",
"snatch": true,
"audit": false, //是否认证
"visible": true, //是否可见
"score": 8, //客户评分
"index": 100,
"lock": 0,
"type": "SNATCH",
"got": true, //是否收寄货物
"detailText": "电话:虹口区江湾查询电话:021-35070256 021-65256173;客服电话:021-35070256 021-65256173;取件电话:021-65869074;投诉电话:021-65285319。名称:上海市虹口区江湾...", //详情
"lastModify": "2016-06-02", //最近更新日期
"source": "SNATCH",
"url": "http://116.228.70.245:8088/BDM/OutWebService/StationPlace/FindStatonPage?StationCode=210026&callback=jsonp1342680517040", //原始页面Url地址
"telOne": "021-35070256", //主要电话
"subTel": null,
"netUsers": []
},
"companyTotal": [
{
"companyName": "汇通",
"companyNumber": "huitongkuaidi",
"companyId": 6,
"count": 8
}
],
"total": 8
}
"status": 500,
"message": "服务器错误"
状态码 | 状态码信息 | 描述 |
---|---|---|
200 | 成功 | |
500 | 服务器错误 | |
401 | 参数错误 |
由快递100团队研发,可以帮助用户快速获取快递网点位置、电话等信息,判断某快递是否可以到达某地,用于网点布局参考。
参数中的快递公司请使用该表对应的编码
快递公司编码表:
http://api.kuaidi100.com/manager/openapi/download/kdbm.do