java对接顺丰（丰桥）查询物流接口

我这边只对接了顺丰的查询路由的接口。因为我公司下单是通过顺丰公司下单的。就是他们的快递员下单。我们的人员贴着快递单号。没有订单号。查询的时候也是通过物流单去查询的。本来准备用快递鸟去查询。但是快递鸟查询顺丰的单需要输入收件方或者发件方的末尾4位电话号码。这样操作非常的麻烦。我们只想通过单号去查询。这4位电话号码没人去输入。没办法。只好来顺丰官网对接了他们的路由查询接口。注意。必须要有顺丰月结号的才可以对接哦。如果公司没有的话。就去申请一个。

首先进入丰桥的官网

https://qiao.sf-express.com/pages/service/newIndex.html

1、注册一个账号。并且录入公司信息和月结号等信息、见下图。

2、我的api接口，从这里添加需要的接口

3、添加完以后，顺丰会发送一个唯一的顾客编码和校验码。会发送到你留的邮箱里。拿着这个顾客编码和校验码，先在在线测试工具下测试，测试3遍成功以后。才可以申请正式环境。此处注意。第一个下订单的接口必须配置。就算不用的话也要配置。我这里只用了第三个路由查询接口。调用成功了。

4、注意这里有个我的电子面单必须是必选项。说是要我们上传自己打印的电子面单的样式。因为我这里只是路由查询接口。电子订单用的还是顺丰自己的面单。这个时候需要在帮助中心申请提问不需要上传面单。只是要查询路由。顺丰后台会帮忙把这一步骤省略掉。直接跳过这一步。

5、然后下载丰桥sdk，相对应的有java ，nodesjs等等版本的。我这边下载的是java的sdk

6、java sdk丰桥用的还是httpclient.安卓这边已经不支持httpclient了。丰桥的sdk有一个java包。这个java包已经很旧了。不实用。后来我测试的时候直接摒弃了这个jar包。

7、测试的时候用的是HttpURLconnection 去做的网络请求。代码如下。将下面代码的顾客编码和校验码替换为自己的。此处单号最好改为自己公司的单号。因为我的单号是绑定我公司的月结号的。这样就可以跳过必须输入手机号码末尾4位的问题。可以直接查到物流信息。

/**
 * 调用顺丰api 查询快递接口
 */
package meiaomie.com.invoicing.utils;

import android.util.Log;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.OutputStreamWriter;
import java.io.UnsupportedEncodingException;
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;
import java.util.UUID;

import Decoder.BASE64Encoder;
import meiaomie.com.invoicing.manager.OkHttpManager;


public class TestCallExpressNewAPIService {

    //丰桥新沙箱测试顾客编码  Yg4Zf06w_sxZs3A5D
    //校验码                          3Xdk1jqeG1Xod9nUXus8Op7DNOkchTnw
    private static final String CLIENT_CODE = "";  //此处替换为您在丰桥平台获取的顾客编码
    private static final String CHECK_WORD = "";//此处替换为您在丰桥平台获取的校验码

    private static final String EXP_RECE_CREATE_ORDER = "EXP_RECE_SEARCH_ROUTES";

    //沙箱环境的地址
    private static final String CALL_URL_BOX = "https://sfapi-sbox.sf-express.com/std/service";
    //生产环境的地址
    private static final String CALL_URL_PROD = "https://sfapi.sf-express.com/std/service";
    String result="";
    HashMap<String, String> params = new HashMap<String, String>();
    public void start() {
        // set common header
        String timeStamp = String.valueOf(System.currentTimeMillis());
        Log.e("timeStamp", timeStamp );
        timeStamp="1624946773234";
        String msgData = "{\n" +
                "\t\"language\": \"0\",\n" +
                "\t\"trackingType\": \"1\",\n" +
                "\t\"trackingNumber\": [\"SF1199158951874\"],\n" +
                "\t\"methodType\": \"1\"\n" +
                "}";
//        String msgData="{"+
//                "'language':'0',"+
//                "'trackingType':'1',"+
//                "'trackingNumber':'[SF1199158951874]',"+
//                "'methodType':'1'"+
//                "}";
//        String msgData = "{" +
//                "language: 0," +
//                "trackingType: 1," +
//                "trackingNumber: [SF1199158951874]," +
//                "methodType: 1" +
//                "}";

        String uuid=UUID.randomUUID().toString().replace("-", "");
        Log.e("uuid", uuid );
        uuid="050c3b6de84b4fc3a8bcb39f743bed48";
        params.put("partnerID", CLIENT_CODE);  // 顾客编码 ，对应丰桥上获取的clientCode
        params.put("requestID", uuid);
        params.put("serviceCode", EXP_RECE_CREATE_ORDER);// 接口服务码
        params.put("timestamp", timeStamp);

        params.put("msgData", msgData);

        //将业务报文+时间戳+校验码组合成需加密的字符串(注意顺序)
        String toVerifyText = msgData + timeStamp + CHECK_WORD;
        String msgDigest = "";
        Log.e("111", toVerifyText );
        //因业务报文中可能包含加号、空格等特殊字符，需要urlEnCode处理
        try {
            toVerifyText = URLEncoder.encode(toVerifyText, "UTF-8");
            Log.e("toVerifyText===========", toVerifyText);
            //进行Md5加密
            MessageDigest md5 = MessageDigest.getInstance("MD5");
            md5.update(toVerifyText.getBytes("UTF-8"));
            byte[] md = md5.digest();
            //通过BASE64生成数字签名
            msgDigest = new String(new BASE64Encoder().encode(md));
            Log.e("msgDigest===========", msgDigest);
            params.put("msgDigest", msgDigest);
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();
        }


        Thread thread=new Thread(new Runnable() {
            @Override
            public void run() {
                result=sendPost(CALL_URL_PROD, params);
            }
        });

        thread.start();
        
    }



    /**
     * 向指定 URL 发送POST方法的请求
     * url 发送请求的 URL
     * params 请求的参数集合
     * @return 远程资源的响应结果
     */
    @SuppressWarnings("unused")
    private  String sendPost(String url, HashMap<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());
                    System.out.println(entry.getKey()+":"+entry.getValue());
                }
                System.out.println("param:"+param.toString());
                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();
            }
        }
        Log.e( "main: ",result.toString());
        return result.toString();
    }
}

总结：丰桥的api接口非常乱。有很多细节。如果不仔细看就很容易漏掉。所以如果是看着丰桥的api接口说明去对接的话。一定要非常仔细的去看。