快寶物流查詢API介面

Lizheng500發表於2022-03-22
API文件 / 物流跟蹤 / 物流查詢

應用場景

1.在電商平臺購物後,通過購物訂單跟蹤物流時,呼叫此API獲取物流資訊詳情

2.處理運費對賬時,一鍵獲取運單物流狀態

3.批量跟蹤及獲取運單物流資訊

支援品牌列表 下載並檢視詳情

技術諮詢請加微信:kuaibao135

介面名稱

express.info.get

公共引數

請求地址

環境名稱
HTTPS請求地址
正式地址

公共請求引數

名稱
型別
是否必須
描述
method string
API介面名稱
app_id string
使用者ID(註冊開放平臺時分配,在控制檯中檢視)
sign string
按照規則(md5(app_id + method + ts + api_key))生成的合法性驗證簽名(32位字串,字母小寫)如:10000cloud.print.do1524209949bdf3b5f50865ac813cbdfd6c9b572b79加密後5030cae3388ecdc2e686379753a0564c
ts string
當前請求的時間戳(10位或13位)
data string
JSON格式請求引數

公共響應引數

名稱
型別
是否必須
描述
code int
響應狀態碼。0-成功,非0-失敗 下載並檢視詳情
msg string
返回結果說明
uid string
本次請求唯一業務流水號
data string
JSON格式響應資料

請求引數

名稱
型別
是否必須
描述
waybill_codes string
運單號,多個單號之間用","隔開(英文逗號),最多支援10條
cp_code string
運單號所屬快遞品牌,需傳簡稱;支援品牌的簡稱請檢視品牌列表 下載並檢視詳情,不傳輸品牌欄位時介面會自動識別品牌後返回結果
result_sort string
返回的物流資訊排序(根據物流時間,0-降序排列,1-升序排列,預設值0)
phone string
查順豐快遞時,必填。收發件人,手機號碼,後4位(如電話號碼13900001234,填寫1234即可)

響應引數

名稱
型別
是否必須
描述
waybill_code string
運單號
cp_code string
快遞公司品牌;支援品牌列表 下載並檢視詳情
status string
物流狀態(collected-已攬收;sending-運輸中;delivering-派件中;allorgraph-已代收;signed-已簽收;question-問題件;)
data
array
詳細物流資訊
order string
物流軌跡順序,desc 代表降序排列, asc 代表升序排列

請求示例

Java
C#
Python
PHP
Node.js
Curl
import java.security.MessageDigest;import java.security.NoSuchAlgorithmException;import java.util.Map;import java.util.HashMap;import java.util.Date;public class Request {public static void main(String[] args) {String host = "
Map<String, String> headers = new HashMap<String, String>();//根據API的要求,定義相對應的Content-Typeheaders.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");
Map<String, String> querys = new HashMap<String, String>();
Map<String, String> bodys = new HashMap<String, String>();String appId = "50001";String method = "express.info.get";// 當前時間戳String ts = new Date().getTime() + "";String appKey = "bdf3b5f50865ac813cbdfd6c9b572b79";// 計算簽名String signStr = appId + method + ts + appKey;String sign = Request.getMD5(signStr, 32);
bodys.put("app_id", appId);
bodys.put("method", method);
bodys.put("ts", ts);
bodys.put("sign", sign);// data引數是個json格式的字串  建議使用函式或方法去生成bodys.put("data", "{ "waybill_codes":"物流單號多個的以英文逗號分隔", "cp_code":"品牌簡稱","result_sort":"0"}");try {	/**
	* 重要提示如下:
	* HttpUtils請從
	* 
	* 下載
	*
	* 相應的依賴請參照
	* 
	*/
	HttpResponse response = HttpUtils.doPost(host, path, requestMethod, headers, querys, bodys);
	System.out.println(response.toString());	
		//獲取response的body
		System.out.println(EntityUtils.toString(response.getEntity()));
	} catch (Exception e) {
		e.printStackTrace();
	}
}	// 計算md5
    public static String getMD5(String plainText, int length) {        try {
            MessageDigest md = MessageDigest.getInstance("MD5");//獲取MD5例項
            md.update(plainText.getBytes());//此處傳入要加密的byte型別值
            byte[] digest = md.digest();//此處得到的是md5加密後的byte型別值
            /*
               下邊的運算就是自己新增的一些二次小加密,記住這個千萬不能弄錯亂,
                   否則在解密的時候,你會發現值不對的(舉例:在註冊的時候加密方式是一種,
                在我們登入的時候是不是還需要加密它的密碼然後和資料庫的進行比對,但是
            最後我們發現,明明密碼對啊,就是打不到預期效果,這時候你就要想一下,你是否
             有改動前後的加密方式)   
            */
            int i;
            StringBuilder sb = new StringBuilder();            for (int offset = 0; offset < digest.length; offset++) {
                i = digest[offset];                if (i < 0)
                    i += 256;                if (i < 16)
                    sb.append(0);
                sb.append(Integer.toHexString(i));//通過Integer.toHexString方法把值變為16進位制
            }            return sb.toString().substring(0, length);//從下標0開始,length目的是擷取多少長度的值
        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();            return null;
        }
    }
}

響應示例

成功響應示例

JSON示例
{
" code " :
int0
" msg " :
string "查詢成功"
" data " : [
0 : {
" waybill_code " :
string "3339809700595"
" cp_code " :
string "sto"
" status " :
string "signed"
" data " : [
0 : {
" time " :
string "2017-10-03 19:11:00"
" context " :
string "已簽收,簽收人是代簽"
}
1 : {
" time " :
string "2017-10-03 08:14:33"
" context " :
string "快件已到達 浙江浦江公司"
}
2 : {
" time " :
string "2017-10-03 01:09:41"
" context " :
string "由浙江義烏中轉部 發往 浙江浦江公司"
}
]
" order " :
string "desc"
}
]
}

異常響應示例

JSON示例
{
" code " :
string "錯誤程式碼"
" msg " :
string "錯誤資訊"
" data " : {
}
}

錯誤程式碼

錯誤碼
描述
201101 查詢暫無記錄
201102 請求引數錯誤
201103 不支援的快遞品牌


來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/70015616/viewspace-2882753/,如需轉載,請註明出處,否則將追究法律責任。

相關文章