德邦快遞的接入，關鍵也是組合數據，提交并處理響應數據，流程和順豐差不多，工具類比較簡單，官方文檔都有，在做之前，先把官方文檔都讀一遍，大概知道要找的內容在什么位置，以及了解流程。
對接規范和流程
◆傳輸協議
暫時只支持HTTP協議進行通信。
◆數據傳輸格式
所有接口暫只支持json消息格式。
◆編碼格式：UTF-8
交互編碼格式統一用UTF-8,避免傳遞中文數據出現亂碼。
◆安全驗證
在數據傳輸過程中,為避免數據被篡改,需要對數據進行加密。入參由四個參數組成：
params(請求參數),digest(密文摘要), timestamp(時間戳),companyCode(第三方接入商的公司編碼,雙方約定)
參數傳遞采用http post請求,請求消息頭設置("Content-Type","application/x-www-form-urlencoded;charset=utf-8")
在傳輸的參數中,既要傳遞原始的json字符串params,又要傳輸加密后的摘要digest。
設置有效的請求時間戳,當接收端收到請求端的時間差不在有效的時間戳范圍內,則認為該訂單無效。
德邦開放平臺可以根據不同的公司設置不同的時間戳有效時長。調用方在重發消息時時間戳應重新生成,請求報文的摘要也需要重新生成。
timestamp:
13位Unix時間戳 timestamp = System.currentTimeMillis();
digest:
摘要的生成規則是 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\":\"上海市\",\n" +
" \"companyName\":\"德邦\",\n" +
" \"county\":\"青浦區\",\n" +
" \"mobile\":\"180****2531\",\n" +
" \"name\":\"AAA\",\n" +
" \"province\":\"上海\",\n" +
" \"town\":\"徐涇鎮\"\n" +
" },\n" +
"\n" +
" \"sender\":{\n" +
" \"address\":\"詳細地址\",\n" +
" \"city\":\"上海市\",\n" +
" \"companyName\":\"德邦\",\n" +
" \"county\":\"青浦區\",\n" +
" \"mobile\":\"180****3451\",\n" +
" \"name\":\"AAA\",\n" +
" \"province\":\"上海\",\n" +
" \"town\":\"徐涇鎮\"\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);
}
如無意外，應該會收到成功的響應數據，然后你就可以一次性地把你需要的接口都測試一遍，只需要修改一下傳入的參數，看到一片綠還是挺爽的。測試完，再慢慢逐個完善業務邏輯吧。
