快遞鳥運費結算ISV項目給發貨客戶和快遞網點提供了線上對賬結算服務。該服務可以以嵌入頁的形式實作接入,減少了我們的開發成本,下面詳述具體實作方法。
1、前期準備:
1.1 注冊快遞鳥賬号:http://www.kdniao.com/reg
![](https://img.laitimes.com/img/9ZDMuAjOiMmIsIjOiQnIsICM38CXlZHbvN3cpR2Lc1TPB10QGtWUCpEMJ9CXsxWam9CXwADNvwVZ6l2c052bm9CXUJDT1wkNhVzLcRnbvZ2Lc1TTU9kZkd0Y2xmMMBjVtJWd0ckW65UbM5WOHJWa5kHT20ESjBjUIF2LcRHelR3LcJzLctmch1mclRXY39DOyITOxADNwAzNykDM4EDMy8CX0Vmbu4GZzNmLn9Gbi1yZtl2Lc9CX6MHc0RHaiojIsJye.jpg)
1.2 使用注冊的賬号登入使用者管理背景擷取APIkey,送出實名認證。(*:使用者ID和API key在後面的對接中會用到)
二、技術對接
樣式:
http://test.freight.kdniao.com/index.json?EBusinessID=1990346&DataSign=M2NhNmNlMjVlZTEwNmVkOGUzZDU2MGQxMDg1ZWJhYWE%3D&RequestData=%7B%22Subaccount%22%3A%22%22%2C%22PhoneNo%22%3A%2213168010550%22%2C%22CustomerName%22%3A%22%E6%9D%9C%E7%94%AB%22%2C%22IPAddress%22%3A%22192.168.0.21%22%7D
*:正式位址需要聯系快遞鳥技術支援,QQ群:864836995
URL中參數定義:
名稱 | 類型 | 是否必須 | 描述 |
---|---|---|---|
EBusinessID | String | R | 上述1.2中擷取到的使用者ID |
DataSign | String | R | 資料簽名,規則:Base64(MD5(RequestData+Appkey)),最後對簽名字元串進行URL編碼。注:Appkey值即為1.2中擷取到的API Key |
RequestData | String | R | 請求内容,JSON格式的字元串,要進行URL編碼。具體參數參照如下RequestData參數 |
備注:R-必填(Required)
RequestData參數:
名稱 | 類型 | 是否必須 | 描述 |
---|---|---|---|
CustomerName | String | R | 商戶名稱 |
PhoneNo | String | R | 手機号(很重要,用于唯一标志一個客戶) |
IPAddress | String | R | 操作使用者IP位址,每次請求嵌入頁的時候需要擷取目前客戶的IP,用于防止連結被盜用。 |