关于物流快递单号查询API接口的实现

原创

app玩家

修改于 2021-05-24 10:48:16

9440

修改于 2021-05-24 10:48:16

文章被收录于专栏：快递接口

之前有做的公司项目需要用到物流查询的接口，我在网上找了挺多的资料，后来自己整理了一下，具体的实现步骤如下

之前有介绍过一些单号接口的应用，在这里介绍一下快递鸟查询接口的简单应用，再次封装一个cURL发送方法写出：如果不想用这个函数，也可以使用file_get_content() 方法效果一致。在这里，我们来使用cURL方法来实现

（一）接入流程：

1>.注册账号，

API_ID：XXXXXX

API_KEY：XXXXXXXXXXXXXXXXXX

2>.服务申请

在个人中心里面申请需要的服务，即时查询功能有免费的服务

3>.对接服务

写自己的业务逻辑----本文主体

4>.测试代码

5>.正式使用

项目搭建

打开Eclipse，创建一个Dynamic Web Project ，命名KDAPI。

可根据自己的需求，建立以下的几个文件：

其中KdniaoTrackQueryApi中的文件是我们从官方进行下载的即时查询的demo源文件，直接进行复制即可，不过在后续我们会对其进行一些更改。

我们把KdniaoTrackQueryApi中的main方法剪切并粘贴在Query文件中，输入一个快递公司的编码和快递号进行查询，并查看结果。

这个时候的结果很显然是不尽人意的，因为JSON的形式不利于用户的观看，所以我们在web查询页面进行展示的时候，还需要对其进行转变，使普通用户也可以很方便的查看快递信息。

所以我们再来对KdniaoTrackQueryApi文件中的getOrderTracesByJson方法进行改造。删除最后的return result，并添加如下代码：

String show = "";
        try {
            JSONObject obj = JSONObject.parseObject(result);

            boolean bool = obj.getBooleanValue("Success");

            if (!bool) {
                show = "暂时无法查询到该物流轨迹信息。";
            } else {
                JSONArray arr = obj.getJSONArray("Traces");
                for (int i = 0; i < arr.size(); i++) {
                    JSONObject o = (JSONObject) arr.get(i);
                    show = show + o.getString("AcceptTime") + "<br/>";
                    show = show + o.getString("AcceptStation") + "<br/><br/>";
                }
            
            }
        }catch (Exception e) {
            e.printStackTrace();
        }        
        return show;

之后，基本就可以正常显示了。

由于用户ID和API秘钥比较私密（如果你花钱购买了增值服务的话），所以就需要用一个api.properties文件存储我们的信息，然后在文件中读取即可。

以上内容完成后，我们就可以创建一个Servlet文件来处理请求了。

那么请求都应该包含哪些内容呢？根据快递鸟官方提供的即时查询的API，我们可以发现只需要提供两个内容即可——快递公司编码和快递单号，那么前端的布局就产生了。

建立index.jsp，在jsp文件中创建一个表单（用来把数据传到Servlet中，因为目前我只会这一种传输方法，所以就只能用这个了），嵌套一个input的text输入传输快递单号。

因为我们是试用版的用户，所以我们只有四种快递可以选，那么我们就选择四个单选按钮来传输快递公司的值。

接受这些内容之后，我们在Servlet中执行以下方法即可：

response.setContentType("text/html;charset=utf-8");
       KdniaoTrackQueryAPI api = new KdniaoTrackQueryAPI();
       String expCode = request.getParameter("type");
       String expNo = request.getParameter("searchArea");
       String res = null;
       try {
           res = api.getOrderTracesByJson(expCode, expNo);
       } catch (Exception e) {
           // TODO Auto-generated catch block
           e.printStackTrace();
       }
       response.getWriter().write(res);

效果展示

圆通快递