调用第三方快递查询接口实现快递查询

简介: 前两天需要做一个快递查询的需求,由于也是第一次做,完全不懂,但是还是明白这必定是需要调用外部接口来实现,并且应该不是调用快递公司所给的接口,那样一家家对接很麻烦,于是便上网查询了能够提供快递查询接口的公司,国内主流的快递物流查询API接口服务商目前只有三家,分别是菜鸟、快递鸟、快递100,这三家都分别获得了融资,菜鸟是阿里投资的(http://newseed.pedaily.cn/data/invest/40084),为淘系(淘宝和天猫)服务。

前两天需要做一个快递查询的需求,由于也是第一次做,完全不懂,但是还是明白这必定是需要调用外部接口来实现,并且应该不是调用快递公司所给的接口,那样一家家对接很麻烦,于是便上网查询了能够提供快递查询接口的公司,国内主流的快递物流查询API接口服务商目前只有三家,分别是菜鸟、快递鸟、快递100,这三家都分别获得了融资,菜鸟是阿里投资的(http://newseed.pedaily.cn/data/invest/40084),为淘系(淘宝和天猫)服务。快递鸟是中银粤财、东方富海、启赋资本投资的(http://newseed.pedaily.cn/data/invest/41050),为非淘系(拼多多、蘑菇街、网易考拉等)服务。快递100是京东、国信弘盛投资的( https://zdb.pedaily.cn/inv/show12486 ),为京东、百度等服务。类似阿里云这类应用市场平台,入驻这类的平台的很多服务商都是用的快递鸟免费物流接口,快递鸟除快递查询API接口之外,还提供了其他的服务接口(快递鸟API接口-为电商提供最全面的物流api服务),也更加完善,如果想在将来对自己产品的物流模块全流程业务进行功能完善,个人推荐选择快递鸟,快递鸟是全球最大的第三方快递物流接口服务商, 目前已经集成了418家快递单号查询接口,31家电子面单接口。高实时、高稳定、高并发,支持快递单号自动识别。本人公司选择的是快递鸟(https://www.kdniao.com),所以就以快递鸟作为案例进行解说吧。

快递鸟第三方快递查询接口很好用,关键免费,使用的用户很多,有十几个千人技术QQ群为用户免费的技术支持接入服务,整个对接非常简单,到快递鸟网站免费注册申请KEY和ID,下载调用Demo,修改下参数对接后就可以实现快递查询了。

【注册快递鸟账号】快递单号查询接口_电子面单_APIKey授权申请-快递鸟账号注册

快递鸟API key免费注册

注册完成后登入,进入到个人中心,这里需要进行一个实名认证,按公司产品的类型进行一个选择,展示页面如下图

快递鸟实名认证
认证完成后在我的产品服务中选择自己所需要的服务,当然对于初创型公司来说选择免费版就够了,等到业务做大时再选择其他产品服务

还有就是在个人中心中如下图所示,我们需要记住的是用户ID,和API key(不要泄露),这将是我们进行接口调用时需要用到的,

【调用接口文档】快递物流api接口文档下载_电子面单接口文档-快递鸟code接口文档

说完了上面的,接下来我们就开始调用API进行开发吧,打开首页中API文档,选择即时查询,我们可以看到它对改接口的介绍,我们来看看对于参数的说明,下图是在发送请求时所需的参数

快递鸟API参数说明

下图是进行接口请求时需要用的参数,这里需要说明下,每个所提供接口的公司他们对物流公司的编码都不同,可以下载他们提供的编码文档进行查询(http://www.kdniao.com/file/2019快递鸟接口支持快递公司编码.xlsx),避免出现错误,当然快递鸟也有提供根据物流单号查询智能查询快递公司以及编码,下面我会一起详细介绍

下图是请求成功后返回的数据

我们可以下载他们写好的分别是即时查询接口demo(快递鸟「即时查询DEMO」让对接更简单)和单号识别接口demo进行更改,这里就不打开demo了,我直接讲解我修改后的,并且也不讲解前端代码,大家只要根据文档来进行数据传输就可以了,后端代码这里建议大家将以下数据抽取出来单独建一个类,方便以后信息修改:

公共信息

/快递鸟查询快递信息/
public class ShoppingCricleLogisticKey {

//电商ID
public static final String EBusinessID="***";
//电商加密私钥,快递鸟提供,注意保管,不要泄漏
public static final String AppKey="*****";
//根据单号和快递公司编码来查询物流信息接口
public static final String ReqURL="http://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx";
//通过单号识别来查询快递公司接口
public static final String OrderReqURL="http://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx";

}
controller层

@RestController
@RequestMapping("/api/logistics")
public class LogisticController {

@Autowired
private LogisticService logisticService;//及时查询
@Autowired
private OrderDistinguishService orderDistinguishService;//单号识别

// String shipperCode//物流单号(必须),String logisticCode//快递公司编码(必须)

@PostMapping("/findOne")
public Object findOne(@RequestBody Map<String,Object> params){
    String shipperCode =String.valueOf(params.get("shipperCode"));
    String logisticCode =String.valueOf(params.get("logisticCode"));
    try {
        return JSON.parse(logisticService.getOrderTracesByJson(shipperCode,logisticCode));

    } catch (Exception e) {
        throw new ServiceException("未查到该单号信息,请确认单号信息是否准确");
    }
}
//根据快递单号查询快递公司以及快递公司编码
@GetMapping("/findCompany/{logisticCode}")
public Object findCompany(@PathVariable("logisticCode")String logisticCode){
    try {
        return JSON.parse(orderDistinguishService.getOrderTracesByJson(logisticCode));
    } catch (Exception e) {
        throw new ServiceException("未查到该单号信息,请确认单号信息是否准确");
    }
}

}
由于即时查询接口demo和单号识别接口demo它们中的部分方法有所重复,故对它们重复的方法进行抽取,作为公共的方法:

公共方法类

public class LogisticsUntil {

public static String MD5(String str, String charset) throws Exception {
    MessageDigest md = MessageDigest.getInstance("MD5");
    md.update(str.getBytes(charset));
    byte[] result = md.digest();
    StringBuffer sb = new StringBuffer(32);
    for (int i = 0; i < result.length; i++) {
        int val = result[i] & 0xff;
        if (val <= 0xf) {
            sb.append("0");
        }
        sb.append(Integer.toHexString(val));
    }
    return sb.toString().toLowerCase();
}
public static String sendPost(String url, Map<String, String> params) {
    OutputStreamWriter out = null;
    BufferedReader in = null;
    StringBuilder result = new StringBuilder();
    try {
        URL realUrl = new URL(url);
        HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection();
        // 发送POST请求必须设置如下两行
        conn.setDoOutput(true);
        conn.setDoInput(true);
        // POST方法
        conn.setRequestMethod("POST");
        // 设置通用的请求属性
        conn.setRequestProperty("accept", "*/*");
        conn.setRequestProperty("connection", "Keep-Alive");
        conn.setRequestProperty("user-agent",
                "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
        conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
        conn.connect();
        // 获取URLConnection对象对应的输出流
        out = new OutputStreamWriter(conn.getOutputStream(), "UTF-8");
        // 发送请求参数
        if (params != null) {
            StringBuilder param = new StringBuilder();
            for (Map.Entry<String, String> entry : params.entrySet()) {
                if(param.length()>0){
                    param.append("&");
                }
                param.append(entry.getKey());
                param.append("=");
                param.append(entry.getValue());
            }
            out.write(param.toString());
        }
        // flush输出流的缓冲
        out.flush();
        // 定义BufferedReader输入流来读取URL的响应
        in = new BufferedReader(
                new InputStreamReader(conn.getInputStream(), "UTF-8"));
        String line;
        while ((line = in.readLine()) != null) {
            result.append(line);
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
    //使用finally块来关闭输出流、输入流
    finally{
        try{
            if(out!=null){
                out.close();
            }
            if(in!=null){
                in.close();
            }
        }
        catch(IOException ex){
            ex.printStackTrace();
        }
    }
    return result.toString();
}

public static char[] base64EncodeChars = new char[] {
        'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H',
        'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P',
        'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X',
        'Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f',
        'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n',
        'o', 'p', 'q', 'r', 's', 't', 'u', 'v',
        'w', 'x', 'y', 'z', '0', '1', '2', '3',
        '4', '5', '6', '7', '8', '9', '+', '/' };

public static String base64Encode(byte[] data) {
    StringBuffer sb = new StringBuffer();
    int len = data.length;
    int i = 0;
    int b1, b2, b3;
    while (i < len) {
        b1 = data[i++] & 0xff;
        if (i == len)
        {
            sb.append(base64EncodeChars[b1 >>> 2]);
            sb.append(base64EncodeChars[(b1 & 0x3) << 4]);
            sb.append("==");
            break;
        }
        b2 = data[i++] & 0xff;
        if (i == len)
        {
            sb.append(base64EncodeChars[b1 >>> 2]);
            sb.append(base64EncodeChars[((b1 & 0x03) << 4) | ((b2 & 0xf0) >>> 4)]);
            sb.append(base64EncodeChars[(b2 & 0x0f) << 2]);
            sb.append("=");
            break;
        }
        b3 = data[i++] & 0xff;
        sb.append(base64EncodeChars[b1 >>> 2]);
        sb.append(base64EncodeChars[((b1 & 0x03) << 4) | ((b2 & 0xf0) >>> 4)]);
        sb.append(base64EncodeChars[((b2 & 0x0f) << 2) | ((b3 & 0xc0) >>> 6)]);
        sb.append(base64EncodeChars[b3 & 0x3f]);
    }
    return sb.toString();
}

}
service层

@Service
public class LogisticService {

/**
 * Json方式 查询订单物流轨迹
 * @throws Exception
 */
public String getOrderTracesByJson(String shipperCode, String logisticCode) throws Exception{
    String requestData= "{'OrderCode':'','ShipperCode':'" + shipperCode + "','LogisticCode':'" + logisticCode + "'}";

    Map<String, String> params = new HashMap<String, String>();
    params.put("RequestData", urlEncoder(requestData, "UTF-8"));
    params.put("EBusinessID", ShoppingCricleLogisticKey.EBusinessID);
    params.put("RequestType", "1002");
    String dataSign=encrypt(requestData, ShoppingCricleLogisticKey.AppKey, "UTF-8");
    params.put("DataSign", urlEncoder(dataSign, "UTF-8"));
    params.put("DataType", "2");

    String result=sendPost(ShoppingCricleLogisticKey.ReqURL, params);

    //根据公司业务处理返回的信息......

    return result;
}

/**
 * MD5加密
 * @param str 内容
 * @param charset 编码方式
 * @throws Exception
 */
@SuppressWarnings("unused")
private String MD5(String str, String charset) throws Exception {
    return LogisticsUntil.MD5(str,charset);
}

/**
 * base64编码
 * @param str 内容
 * @param charset 编码方式
 * @throws UnsupportedEncodingException
 */
private String base64(String str, String charset) throws UnsupportedEncodingException{
    String encoded = base64Encode(str.getBytes(charset));
    return encoded;
}

@SuppressWarnings("unused")
private String urlEncoder(String str, String charset) throws UnsupportedEncodingException{
    String result = URLEncoder.encode(str, charset);
    return result;
}

/**
 * 电商Sign签名生成
 * @param content 内容
 * @param keyValue Appkey
 * @param charset 编码方式
 * @throws UnsupportedEncodingException ,Exception
 * @return DataSign签名
 */
@SuppressWarnings("unused")
private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exception
{
    if (keyValue != null)
    {
        return base64(MD5(content + keyValue, charset), charset);
    }
    return base64(MD5(content, charset), charset);
}

/**
 * 向指定 URL 发送POST方法的请求
 * @param url 发送请求的 URL
 * @param params 请求的参数集合
 * @return 远程资源的响应结果
 */
@SuppressWarnings("unused")
public String sendPost(String url, Map<String, String> params) {
    return LogisticsUntil.sendPost(url,params);
}

public static String base64Encode(byte[] data) {
    return LogisticsUntil.base64Encode(data);
}

}

@Service
public class OrderDistinguishService {

public String getOrderTracesByJson(String expNo) throws Exception{
    String requestData= "{'LogisticCode':'" + expNo + "'}";

    Map<String, String> params = new HashMap<String, String>();
    params.put("RequestData", urlEncoder(requestData, "UTF-8"));
    params.put("EBusinessID", ShoppingCricleLogisticKey.EBusinessID);
    params.put("RequestType", "2002");
    String dataSign=encrypt(requestData, ShoppingCricleLogisticKey.AppKey, "UTF-8");
    params.put("DataSign", urlEncoder(dataSign, "UTF-8"));
    params.put("DataType", "2");

    String result=sendPost(ShoppingCricleLogisticKey.OrderReqURL, params);

    //根据公司业务处理返回的信息......

    return result;
}

/**
 * MD5加密
 * @param str 内容
 * @param charset 编码方式
 * @throws Exception
 */
@SuppressWarnings("unused")
private String MD5(String str, String charset) throws Exception {
  return LogisticsUntil.MD5(str,charset);
}

/**
 * base64编码
 * @param str 内容
 * @param charset 编码方式
 * @throws UnsupportedEncodingException
 */
private String base64(String str, String charset) throws UnsupportedEncodingException{
    String encoded = base64Encode(str.getBytes(charset));
    return encoded;
}

@SuppressWarnings("unused")
private String urlEncoder(String str, String charset) throws UnsupportedEncodingException{
    String result = URLEncoder.encode(str, charset);
    return result;
}

/**
 * 电商Sign签名生成
 * @param content 内容
 * @param keyValue Appkey
 * @param charset 编码方式
 * @throws UnsupportedEncodingException ,Exception
 * @return DataSign签名
 */
@SuppressWarnings("unused")
private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exception
{
    if (keyValue != null)
    {
        return base64(MD5(content + keyValue, charset), charset);
    }
    return base64(MD5(content, charset), charset);
}

/**
 * 向指定 URL 发送POST方法的请求
 * @param url 发送请求的 URL
 * @param params 请求的参数集合
 * @return 远程资源的响应结果
 */
@SuppressWarnings("unused")
private String sendPost(String url, Map<String, String> params) {
   return LogisticsUntil.sendPost(url,params);
}

public static String base64Encode(byte[] data) {
    return LogisticsUntil.base64Encode(data);
}

}

这里测试返回的数据大家可以参考API所提供的数据,形式就跟我们在支付宝上查询的物流信息一样,美化的话就需要靠前端了,这里就不给大家展示了。

快递鸟API推送的物流状态

快递鸟API查询的物流动态

目录
相关文章
|
1天前
|
搜索推荐 数据挖掘 API
探讨拼多多商品 API 接口:运用及收益
拼多多以其独特的商业模式迅速崛起,成为电商领域的重要力量。拼多多商品API接口为开发者和企业提供了一套强大的工具,能够获取丰富的商品信息,包括基本资料、价格详情、库存数据、商品图片、销售属性、销量数据及用户评价等。该接口在电商平台拓展、数据分析、移动应用开发和营销推广等多个领域展现出卓越的应用价值,不仅促进了销售额和利润的增长,还优化了用户体验,积累了宝贵的数据资产,为企业战略决策提供了重要依据。
28 5
|
21天前
|
数据挖掘 API 数据安全/隐私保护
淘宝商品 API 接口怎样去使用?
淘宝商品API接口为开发者和企业提供了一种强大的工具,用于高效获取和利用淘宝平台上的商品数据。本文详细介绍了从注册成为淘宝开发者、申请API权限、获取API密钥,到阅读API文档、搭建开发环境、调用API接口、处理响应结果及数据应用的全过程。通过实际案例展示了如何利用淘宝商品API接口提升电商平台和价格比较网站的竞争力,并强调了使用过程中的注意事项,如遵守API使用规范、数据安全与隐私保护等。
86 0
|
2月前
|
JSON 安全 API
淘宝 API 接口:解锁商品详情的强大工具
淘宝API接口在电商领域扮演着关键角色,为商家和开发者提供强大的数据支持和服务能力。它不仅帮助商家获取商品信息、管理订单和物流,还支持数据分析、价格调整等功能,助力商家在竞争激烈的市场中取得成功。此外,通过注册认证、搭建开发环境等步骤,开发者可快速上手并利用丰富的技术文档和社区支持进行高效开发。
|
5月前
|
JSON 数据挖掘 API
京东商品详情API:解锁电商数据的金钥匙
**《京东商品详情API:解锁电商数据》** 本文介绍如何通过京东API获取商品详情,包括注册成为开发者、获取App Key和App Secret、申请API权限、理解`jd.item.get`接口、构建HTTP请求、解析JSON响应。应用场景广泛,如电商平台、比价、数据分析和移动应用。注意调用限制、数据安全和合规性。示例代码展示了Python调用流程。利用此API可增强电商竞争力。请按最新文档和政策执行。
|
6月前
|
API 开发者
lazada获得lazada商品详情 API 返回值说明
Lazada 是东南亚地区的一个电商巨头,提供了一系列的 API 接口供开发者使用。对于获取 Lazada 商品详情的 API,其返回值会包含商品的详细信息。以下是一个示例的返回值说明,但请注意,实际的返回值可能会根据 API 的版本和具体实现有所不同,建议参考官方的 API 文档以获取最准确的信息。
|
6月前
|
供应链 API 开发者
阿里系接口推荐:1688商品详情数据接口
阿里系接口推荐:1688商品详情数据接口
60 10
|
6月前
|
SQL 缓存 测试技术
API接口对接中需要注意的问题(4)
有几个关键的问题需要注意,它们涉及安全性、性能、数据一致性和错误处理等方面
|
6月前
|
API
怎样获取当当网dangdang商品详情 API 返回值说明?
当当网(dangdang.com)的API(Application Programming Interface)返回值详细说明可能会随着API的更新和迭代而有所变化。通常,一个商品详情API的返回值会包含有关商品的详细信息,如商品ID、名称、价格、描述、图片链接、评价、分类等。
|
6月前
|
存储 JSON 数据挖掘
快手商品详情数据接口解析和封装
快手商品详情数据接口解析和封装
|
6月前
|
监控 搜索推荐 数据挖掘
淘宝/天猫商品详情API:返回值参数详解及商业逻辑实现
在电子商务的高速发展过程中,API接口扮演了至关重要的角色。对于淘宝和天猫这样的大型电商平台,商品详情API是商家与消费者信息沟通的桥梁。本文将深入探讨这一API的返回值参数,并展示如何通过编程利用这些数据实现商业逻辑。