昨天做的公司项目需要用到快递查询的接口,我在网上找了挺多的资料,后来自己整理了一下,具体的实现步骤如下(我使用的是聚合科技的快递接口):
1.先在聚合科技注册一个账号,然后免费申请使用这个接口,就可以得到一个分配给你的key
2.点击个人中心->数据中心->我的接口->接口,就可以查看API文档、实例代码。
3.点击个人中心->数据中心->我的接口->测试,在提示的地方输入真实正确的库快递信息就可以查到物流信息。
4.查询成功后可以在该页面的请求详情中看到自己的key:
5.最后是根据给出的实例代码就可以在项目中使用了。
这是我自己整合的一些重要参数:
名称 | 类型 | 必填 | 说明 |
com | String | 是 | 需要查询的快递公司编号 |
no | String | 是 | 需要查询的订单号 |
key | String | 是 | 应用APPKEY(应用详细页查询) |
dtype | String | 否 | 返回数据的格式,xml或json,默认json |
SenderPhone | Int | 否 | 发件人的手机后四位(顺丰快递查询时要提供发件人或者收件人的其中一个) |
ReceiverPhone | Int | 否 | 收件人的手机号码后四位(顺丰快递查询时要提供发件人或者收件人的其中一个) |
接口地址 | Url | 是 | http://v.juhe.cn/exp/index |
请求方式 |
|
| Get/post |
支持格式 |
|
| Json/xml |
还有一些快递公司的编号:
快递公司 | 快递公司编号 |
顺丰 | sf |
申通 | sto |
圆通 | yt |
汇通 | ht |
中通 | zto |
EMS | ems |
韵达 | yd |
实例代码如下:
(使用 net.sf.json.JSONObject包是需要导入一些jar包,不然会报错,这个在百度上搜索会有一大堆的,就不放上来了。)
import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.util.HashMap;
import java.util.Map;
import net.sf.json.JSONObject;
public class Test {
/**
*常用快递调用示例代码 - 聚合数据
*在线接口文档:http://www.juhe.cn/docs/43
**/
public static final String DEF_CHATSET = "UTF-8";
public static final int DEF_CONN_TIMEOUT = 30000;
public static final int DEF_READ_TIMEOUT = 30000;
public static String userAgent = "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.66 Safari/537.36";
//配置您申请的KEY
public static final String APPKEY ="你申请的key";
//1.常用快递查询API
public static void getRequest1(){
String result =null;
String url ="http://v.juhe.cn/exp/index";//请求接口地址
Map params = new HashMap();//请求参数
params.put("com","快递公司编号");//需要查询的快递公司编号
params.put("no","订单号");//需要查询的订单号
params.put("key",APPKEY);//应用APPKEY(应用详细页查询)
params.put("dtype","json");//返回数据的格式,xml或json,默认json
try {
result =net(url, params, "GET");
JSONObject object = JSONObject.fromObject(result);
if(object.getInt("error_code")==0){
System.out.println(object.get("result"));
}else{
System.out.println(object.get("error_code")+":"+object.get("reason"));
}
} catch (Exception e) {
e.printStackTrace();
}
}
//2.快递公司编号对照表
public static void getRequest2(){
String result =null;
String url ="http://v.juhe.cn/exp/com";//请求接口地址
Map params = new HashMap();//请求参数
try {
result =net(url, params, "GET");
JSONObject object = JSONObject.fromObject(result);
if(object.getInt("error_code")==0){
System.out.println(object.get("result"));
}else{
System.out.println(object.get("error_code")+":"+object.get("reason"));
}
} catch (Exception e) {
e.printStackTrace();
}
}
public static void main(String[] args) {
(new Test()).getRequest1();
(new Test()).getRequest2();
}
/**
*
* @param strUrl 请求地址
* @param params 请求参数
* @param method 请求方法
* @return 网络请求字符串
* @throws Exception
*/
public static String net(String strUrl, Map params,String method) throws Exception {
HttpURLConnection conn = null;
BufferedReader reader = null;
String rs = null;
try {
StringBuffer sb = new StringBuffer();
if(method==null || method.equals("GET")){
strUrl = strUrl+"?"+urlencode(params);
}
URL url = new URL(strUrl);
conn = (HttpURLConnection) url.openConnection();
if(method==null || method.equals("GET")){
conn.setRequestMethod("GET");
}else{
conn.setRequestMethod("POST");
conn.setDoOutput(true);
}
conn.setRequestProperty("User-agent", userAgent);
conn.setUseCaches(false);
conn.setConnectTimeout(DEF_CONN_TIMEOUT);
conn.setReadTimeout(DEF_READ_TIMEOUT);
conn.setInstanceFollowRedirects(false);
conn.connect();
if (params!= null && method.equals("POST")) {
try {
DataOutputStream out = new DataOutputStream(conn.getOutputStream());
out.writeBytes(urlencode(params));
} catch (Exception e) {
// TODO: handle exception
}
}
InputStream is = conn.getInputStream();
reader = new BufferedReader(new InputStreamReader(is, DEF_CHATSET));
String strRead = null;
while ((strRead = reader.readLine()) != null) {
sb.append(strRead);
}
rs = sb.toString();
} catch (IOException e) {
e.printStackTrace();
} finally {
if (reader != null) {
reader.close();
}
if (conn != null) {
conn.disconnect();
}
}
return rs;
}
//将map型转为请求参数型
public static String urlencode(Map<String,Object>data) {
StringBuilder sb = new StringBuilder();
for (Map.Entry i : data.entrySet()) {
try {
sb.append(i.getKey()).append("=").append(URLEncoder.encode(i.getValue()+"","UTF-8")).append("&");
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
}
return sb.toString();
}
}