德邦快遞接口開發(fā)-java(工具類)

德邦快遞的接入,關鍵也是組合數據,提交并處理響應數據,流程和順豐差不多,工具類比較簡單,官方文檔都有,在做之前,先把官方文檔都讀一遍,大概知道要找的內容在什么位置,以及了解流程。

對接規(guī)范和流程
◆傳輸協(xié)議
暫時只支持HTTP協(xié)議進行通信。
◆數據傳輸格式
所有接口暫只支持json消息格式。
◆編碼格式:UTF-8
交互編碼格式統(tǒng)一用UTF-8,避免傳遞中文數據出現亂碼。
◆安全驗證
在數據傳輸過程中,為避免數據被篡改,需要對數據進行加密。入參由四個參數組成:
params(請求參數),digest(密文摘要), timestamp(時間戳),companyCode(第三方接入商的公司編碼,雙方約定)
參數傳遞采用http post請求,請求消息頭設置("Content-Type","application/x-www-form-urlencoded;charset=utf-8")
在傳輸的參數中,既要傳遞原始的json字符串params,又要傳輸加密后的摘要digest。
設置有效的請求時間戳,當接收端收到請求端的時間差不在有效的時間戳范圍內,則認為該訂單無效。
德邦開放平臺可以根據不同的公司設置不同的時間戳有效時長。調用方在重發(fā)消息時時間戳應重新生成,請求報文的摘要也需要重新生成。
timestamp:
13位Unix時間戳 timestamp = System.currentTimeMillis();
digest:
摘要的生成規(guī)則是 String plainText = params + appkey + timestamp,注意傳遞的timestamp要和加密的timestamp值相同。
加密源碼如下:

private static String getDigest(String plainText) {
    return Base64.encodeBase64String(DigestUtils.md5Hex(plainText).getBytes());
}

Base64引用 : org.apache.commons.codec.binary.Base64
DigestUtils引用 : org.apache.commons.codec.digest.DigestUtils

然后可以測試一個流程是否可行,比如【新】下單服務接口:

static String params = "{\n" + 
        "    \"companyCode\":\"EWB111\",\n" + 
        "    \"custOrderNo\":\"123456\",\n" + 
        "    \"customerCode\":\"12345678\",\n" + 
        "    \"logisticID\":\"LPEXP33343111111113445\",\n" + 
        "    \"needTraceInfo\":1,\n" + 
        "    \"orderType\":\"1\",\n" + 
        "    \"packageInfo\":{\n" + 
        "        \"cargoName\":\"貨物名\",\n" + 
        "        \"deliveryType\":\"9\",\n" + 
        "        \"totalNumber\":2,\n" + 
        "        \"totalVolume\":0.01,\n" + 
        "        \"totalWeight\":1,\n" + 
        "               \"packageService\":\"紙\"\n" + 
        "    },\n" + 
        "    \"receiver\":{\n" + 
        "        \"address\":\"詳細地址\",\n" + 
        "        \"city\":\"上海市\(zhòng)",\n" + 
        "        \"companyName\":\"德邦\",\n" + 
        "        \"county\":\"青浦區(qū)\",\n" + 
        "        \"mobile\":\"180****2531\",\n" + 
        "        \"name\":\"AAA\",\n" + 
        "        \"province\":\"上海\",\n" + 
        "        \"town\":\"徐涇鎮(zhèn)\"\n" + 
        "    },\n" + 
        "\n" + 
        "    \"sender\":{\n" + 
        "        \"address\":\"詳細地址\",\n" + 
        "        \"city\":\"上海市\(zhòng)",\n" + 
        "        \"companyName\":\"德邦\",\n" + 
        "        \"county\":\"青浦區(qū)\",\n" + 
        "        \"mobile\":\"180****3451\",\n" + 
        "        \"name\":\"AAA\",\n" + 
        "        \"province\":\"上海\",\n" + 
        "        \"town\":\"徐涇鎮(zhèn)\"\n" + 
        "    },\n" + 
        "    \"transportType\":\"PACKAGE\",\n" + 
        "       \"gmtCommit\":\"@time\",\n" + 
        "       \"payType\":\"1\",\n" + 
        "       \"isOut\":\"N\"\n" + 
        "}";

public static void main(String[] args) throws JSONException, Exception {
    long timestamp = System.currentTimeMillis();
    Calendar cal = Calendar.getInstance();
    cal.setTimeInMillis(timestamp);
    
    String _params = params.replaceAll("@time", DateUtils.dateToString(cal, "yyyy-MM-dd HH:mm:ss"));
    String digest = getDigest(_params + 你的appkey + timestamp);
    String companyCode = "你的company code";
    
    Map map = new LinkedHashMap();
    map.put("params", _params);
    map.put("digest", digest);
    map.put("timestamp", String.valueOf(timestamp));
    map.put("companyCode", companyCode);
    
    String response = HttpClientUtils.post(NEW_ORDER_URL, map);
    System.out.println(response);
}

如無意外,應該會收到成功的響應數據,然后你就可以一次性地把你需要的接口都測試一遍,只需要修改一下傳入的參數,看到一片綠還是挺爽的。測試完,再慢慢逐個完善業(yè)務邏輯吧。


測試通過
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內容

友情鏈接更多精彩內容