網站API對接文檔
POST
獲取賬戶余額
POST
獲取快遞列表
POST
獲取倉庫列表
POST
獲取禮品/自提件列表
POST
購買禮品/自提件
POST
查詢快遞單號
POST
刪除訂單并退款
POST
更新取件碼
POST
更新第二段上家單號
獲取賬戶余額 更新時間：2022-02-10 17:28:00
基本信息
- 溫馨提示： 下面URL的域名為開發時本地測試用，實際使用時須更改為對接網站域名！
- 接口URL：
http://127.0.0.11:8086/apiv1/get_money.html - 請求方式：
POST - Content-Type：
application/x-www-form-urlencoded
請求參數
body參數及說明
| 參數名 | 示例值 | 參數類型 | 是否必填 | 參數描述 |
|---|---|---|---|---|
| u | 90000 | String | 是 | UID（在"會員中心"→"賬號管理"查看） |
| m | 13888888888 | String | 是 | 登錄賬號 |
| t | 1644484214 | String | 是 | 當前時間戳 |
| sign | 514de2babf88504ecc78c24020c15306 | String | 是 | "ApiKey+8b795683fb9485430ce84ceb78cda9786d564150+UID+登錄賬號+當前時間戳"拼接后進行32位md5加密 （ApiKey在"會員中心"→"賬號管理"查看） |
響應示例
獲取快遞列表 更新時間：2022-02-10 17:28:00
基本信息
- 溫馨提示： 下面URL的域名為開發時本地測試用，實際使用時須更改為對接網站域名！
- 接口URL：
http://127.0.0.11:8086/apiv1/get_express_list.html - 請求方式：
POST - Content-Type：
application/x-www-form-urlencoded
請求參數
body參數及說明
| 參數名 | 示例值 | 參數類型 | 是否必填 | 參數描述 |
|---|---|---|---|---|
| u | 90000 | String | 是 | UID（在"會員中心"→"賬號管理"查看） |
| m | 13888888888 | String | 是 | 登錄賬號 |
| t | 1644484214 | String | 是 | 當前時間戳 |
| sign | 514de2babf88504ecc78c24020c15306 | String | 是 | "ApiKey+8b795683fb9485430ce84ceb78cda9786d564150+UID+登錄賬號+當前時間戳"拼接后進行32位md5加密 （ApiKey在"會員中心"→"賬號管理"查看） |
響應示例
成功響應示例
{
"success": true,
"msg": "快遞列表",
"datalist": [
{
"kdid": "258", //快遞ID
"platform": "1", //1淘寶天貓 2拼多多 3阿里 4京東 9抖音 10快手
"express_type": "3", //1普通面單 2拼多多電子面單 3菜鳥電子面單 4京東無界面單 5抖音電子面單 6快手電子面單
"type": "3", //1系統單號 2寄自提件 3禮品代發 4無貨源中轉 5無貨源安撫
"state": "2", //1正常 2暫停 3下架
"name": "中通快遞", //快遞名稱
"text": "支持【淘寶】【天貓】【阿里】", //支持平臺說明
"remarks": "【1秒-10秒出單號】【不可刪】" //備注說明
},
{
"kdid": "259",
"platform": "2",
"express_type": "2",
"type": "3",
"state": "1",
"name": "中通快遞",
"text": "支持【拼多多】",
"remarks": "【1秒-10秒出單號】【地址錯誤會導致攬收不了，出不了物流】【不可刪】"
}
]
}失敗響應示例
{
"success": false,
"code": 402,
"message": "簽名已過期-1644403644"
}獲取倉庫列表 更新時間：2022-02-10 17:28:00
基本信息
- 溫馨提示： 下面URL的域名為開發時本地測試用，實際使用時須更改為對接網站域名！
- 接口URL：
http://127.0.0.11:8086/apiv1/get_warehouse_list.html - 請求方式：
POST - Content-Type：
application/x-www-form-urlencoded
請求參數
body參數及說明
| 參數名 | 示例值 | 參數類型 | 是否必填 | 參數描述 |
|---|---|---|---|---|
| u | 90000 | String | 是 | UID（在"會員中心"→"賬號管理"查看） |
| m | 13888888888 | String | 是 | 登錄賬號 |
| t | 1644483142 | String | 是 | 當前時間戳 |
| sign | a584259da2ff478cf0e477468b4f43b2 | String | 是 | "ApiKey+8b795683fb9485430ce84ceb78cda9786d564150+UID+登錄賬號+當前時間戳"拼接后進行32位md5加密 （ApiKey在"會員中心"→"賬號管理"查看） |
| kdid | 77 | String | 是 | 快遞ID，請先獲取快遞列表查詢 |
響應示例
成功響應示例
{
"success": true,
"smg": "倉庫列表",
"datalist": [
{
"warehouse": "218", //倉庫ID
"kdid": "77", //快遞ID
"type": "3", //1系統單號 2寄自提件 3禮品代發 4無貨源中轉 5無貨源安撫
"name": "福建泉州", //倉庫名稱
"state": "1", //1正常 2暫停 3下架
"province": "福建省", //省
"city": "泉州市", //市
"district": "安溪縣", //區/縣
"address": "祥云路吾都", //詳細地址
"zipcode": "000000" //郵編
},
{
"warehouse": "3059",
"kdid": "77",
"type": "3",
"name": "蘇州郵政",
"state": "1",
"province": "江蘇省",
"city": "蘇州市",
"district": "昆山市",
"address": "車站路99號",
"zipcode": "000000"
}
]
}失敗響應示例
{
"success": false,
"code": 402,
"message": "簽名錯誤"
}獲取禮品/自提件列表 更新時間：2022-02-10 17:28:00
基本信息
- 溫馨提示： 下面URL的域名為開發時本地測試用，實際使用時須更改為對接網站域名！
- 接口URL：
http://127.0.0.11:8086/apiv2/get_gift_list.html - 請求方式：
POST - Content-Type：
application/x-www-form-urlencoded
請求參數
body參數及說明
| 參數名 | 示例值 | 參數類型 | 是否必填 | 參數描述 |
|---|---|---|---|---|
| u | 90000 | String | 是 | UID（在"會員中心"→"賬號管理"查看） |
| m | 13888888888 | String | 是 | 登錄賬號 |
| t | 1644483142 | String | 是 | 當前時間戳 |
| sign | a584259da2ff478cf0e477468b4f43b2 | String | 是 | "ApiKey+8b795683fb9485430ce84ceb78cda9786d564150+UID+登錄賬號+當前時間戳"拼接后進行32位md5加密 （ApiKey在"會員中心"→"賬號管理"查看） |
響應示例
成功響應示例
{
"success": true,
"msg": "禮品/自提件列表",
"datalist": [
{
"id": "156-3324-11648", //禮品代發 快遞ID-倉庫ID-禮品ID（禮品ID為0時代表是自提件） 下單時傳這個
"money": 1.53, //下單價格
"express_name": "圓通快遞", //快遞名稱
"platform": "抖音", //支持的電商平臺
"gift_image": "http://tupian.aliyuncs.com/61753c03eb9ca.jpg", //禮品圖片
"gift_name": "洗衣粉", //禮品名稱
"weight": "0.10", //禮品重量
"lipin_money": "0.20", //禮品價格
"state": "正常", //禮品狀態
"store_name": "紹興市上虞區", //倉庫名稱
"store_address": "浙江省 紹興市 上虞區 五星西路22號" //倉庫地址
},
{
"id": "95-3589-0", //自提件 快遞ID-倉庫ID-禮品ID（禮品ID為0時代表是自提件） 下單時傳這個
"money": 0.75,
"state": "正常",
"express_name": "圓通快遞",
"platform": "拼多多",
"gift_image": "http://tupian.aliyuncs.com/101/236-1605447255.png",
"gift_name": "自提件",
"store_name": "泉州市鯉城區",
"store_address": "福建省 泉州市 鯉城區 鯉城區濱江路480號"
}
]
}失敗響應示例
{
"success": false,
"code": 402,
"message": "簽名錯誤"
}購買禮品/自提件 更新時間：2022-02-10 17:28:00
基本信息
- 溫馨提示： 下面URL的域名為開發時本地測試用，實際使用時須更改為對接網站域名！
- 接口URL：
http://127.0.0.11:8086/apiv2/buy_waybill_no.html - 請求方式：
POST - Content-Type：
application/x-www-form-urlencoded
請求參數
body參數及說明
| 參數名 | 示例值 | 參數類型 | 是否必填 | 參數描述 |
|---|---|---|---|---|
| u | 90000 | String | 是 | UID（在"會員中心"→"賬號管理"查看） |
| m | 13888888888 | String | 是 | 登錄賬號 |
| t | 1644483142 | String | 是 | 當前時間戳 |
| sign | a584259da2ff478cf0e477468b4f43b2 | String | 是 | "ApiKey+8b795683fb9485430ce84ceb78cda9786d564150+UID+登錄賬號+當前時間戳"拼接后進行32位md5加密 （ApiKey在"會員中心"→"賬號管理"查看） |
| id | 77-218-526 | String | 是 | 快遞ID-倉庫ID-禮品ID（禮品ID為0時代表是自提件） |
| repeat | 0 | String | 是 | 是否允許重復下單（1禁止重復下單，0允許重復下單） |
| s_name | 鐘先生 | String | 是 | 發件人 - 姓名 |
| s_mobile | 15899996666 | String | 是 | 發件人 - 手機 |
| s_province | 浙江省 | String | 是 | 發件人 - 省 |
| s_city | 杭州市 | String | 是 | 發件人 - 市 |
| s_district | 西湖區 | String | 是 | 發件人 - 區/縣 |
| s_address | 健康路88號 | String | 是 | 發件人 - 詳細地址 |
| s_zipcode | 258258 | String | 是 | 發件人 - 郵編 |
| receiver_list | [{"pid":1000005,"r_name":"\u9648\u5148\u751f","r_mobile":"18866669999","r_province":"\u5e7f\u4e1c\u7701","r_city":"\u5e7f\u5dde\u5e02","r_district":"\u767d\u4e91\u533a","r_address":"\u592a\u548c\u9547\u5e78\u798f\u8def99\u53f7","r_zipcode":"528000","r_order":"191228-503460987812219"},{"pid":1000006,"r_name":"\u9648\u5148\u751f","r_mobile":"18866669999","r_province":"\u5e7f\u4e1c\u7701","r_city":"\u5e7f\u5dde\u5e02","r_district":"\u767d\u4e91\u533a","r_address":"\u592a\u548c\u9547\u5e78\u798f\u8def99\u53f7","r_zipcode":"528000","r_order":"191228-503460987812219"}] | String | 是 | 收件人列表，json字符串格式，最高支持6000條。pid：唯一PID，獲取單號時，通過pid獲取對應的快遞單號，重復的pid會顯示已購買的單號，不會重復扣款，但可能會提示錯誤；r_name：收件人；r_mobile：手機號碼；r_province：省；r_city：市；r_district：區/縣；r_address：詳細地址；r_zipcode：郵編；r_order：訂單號（電商平臺的訂單號）；oaid：淘寶接口的id號（淘寶密文取單號時必填）；receive_name_jiami：拼多多收貨人名字加密字符串（拼多多密文取單號時必填）；receive_mobile_jiami：拼多多收貨人電話加密字符串（拼多多密文取單號時必填）；shipping_address_jiami：拼多多收貨人街道加密字符串（拼多多密文取單號時必填）；tracking_number：實際發出快遞單號（無貨源專用必填） |
響應示例
成功響應示例
{
"success": true,
"batch": 1644476623,
"datalist": [
{
"oid": "114934482", //訂單編號
"pid": "1000005", //唯一標識
"waybill_no": "9868143371510" //成功返回的快遞單號，如果沒有立即返回單號可稍后再進行查詢
},
{
"oid": "114934483",
"pid": "1000006",
"waybill_no": "9868143016187"
}
],
"message": "下單成功，點擊確定進入單號記錄查看單號獲取情況。"
}失敗響應示例
{
"success": false,
"message": "倉庫地址參數有誤，請選擇其他倉庫地址（218）"
}查詢快遞單號 更新時間：2022-02-10 17:28:00
基本信息
- 溫馨提示： 下面URL的域名為開發時本地測試用，實際使用時須更改為對接網站域名！
- 接口URL：
http://127.0.0.11:8086/apiv2/get_waybill_no.html - 請求方式：
POST - Content-Type：
application/x-www-form-urlencoded
請求參數
body參數及說明
| 參數名 | 示例值 | 參數類型 | 是否必填 | 參數描述 |
|---|---|---|---|---|
| u | 90000 | String | 是 | UID（在"會員中心"→"賬號管理"查看） |
| m | 13888888888 | String | 是 | 登錄賬號 |
| t | 1644483142 | String | 是 | 當前時間戳 |
| sign | a584259da2ff478cf0e477468b4f43b2 | String | 是 | "ApiKey+8b795683fb9485430ce84ceb78cda9786d564150+UID+登錄賬號+當前時間戳"拼接后進行32位md5加密 （ApiKey在"會員中心"→"賬號管理"查看） |
| pid_list | [1000005,1000006] | String | 是 | 通過pid查詢快遞單號，json字符串格式，最多支持5000條 |
響應示例
成功響應示例
{
"success": true,
"datalist": [
{
"oid": "114934482", //訂單編號
"pid": "1000005", //唯一標識
"state": "3", //訂單狀態 0等待出單號 1已發出 2待截單 3打單中 7準備出單號 11有錯誤 12封禁 13問題件
"waybill_no": "9868143371510", //成功返回的快遞單號
"msg": "" //錯誤提示
},
{
"oid": "114934483",
"pid": "1000006",
"state": "3",
"waybill_no": "9868144224112",
"msg": ""
}
]
}失敗響應示例
{
"success": false,
"code": 402,
"message": "簽名錯誤"
}刪除訂單并退款 更新時間：2022-02-10 17:28:00
基本信息
- 溫馨提示： 下面URL的域名為開發時本地測試用，實際使用時須更改為對接網站域名！
- 接口URL：
http://127.0.0.11:8086/apiv2/del_waybill_no.html - 請求方式：
POST - Content-Type：
application/x-www-form-urlencoded
請求參數
body參數及說明
| 參數名 | 示例值 | 參數類型 | 是否必填 | 參數描述 |
|---|---|---|---|---|
| u | 90000 | String | 是 | UID（在"會員中心"→"賬號管理"查看） |
| m | 13888888888 | String | 是 | 登錄賬號 |
| t | 1644483577 | String | 是 | 當前時間戳 |
| sign | 07110eb9eb5a21fe83ba561246813627 | String | 是 | "ApiKey+8b795683fb9485430ce84ceb78cda9786d564150+UID+登錄賬號+當前時間戳"拼接后進行32位md5加密 （ApiKey在"會員中心"→"賬號管理"查看） |
| type | 1 | String | 是 | 傳入的ID類型（1、購買時返回的訂單編號oid， 2、快遞單號） |
| id_list | [114934481,114934487,114934488,114934489] | String | 是 | 要刪除的oid或快遞單號列表，json字符串格式，最多支持20條 |
響應示例
成功響應示例
{
"success": 3, //刪除成功訂單數量
"success_waybill_no": [ //刪除成功訂單列表
{
"oid": "114934487", //訂單號
"waybill_no": "" //快遞單號
},
{
"oid": "114934488",
"waybill_no": ""
},
{
"oid": "114934489",
"waybill_no": ""
}
],
"fail": 1, //刪除失敗訂單數量
"message": "訂單 114934481：正在打印快遞單號。" //刪除失敗原因
}失敗響應示例
{
"success": false,
"code": 402,
"message": "簽名錯誤"
}更新取件碼 更新時間：2025-02-18 17:28:00
基本信息
- 溫馨提示： 下面URL的域名為開發時本地測試用，實際使用時須更改為對接網站域名！
- 接口URL：
http://127.0.0.11:8086/apiv2/update_codes.html - 請求方式：
POST - Content-Type：
application/x-www-form-urlencoded
請求參數
body參數及說明
| 參數名 | 示例值 | 參數類型 | 是否必填 | 參數描述 |
|---|---|---|---|---|
| u | 90000 | String | 是 | UID（在"會員中心"→"賬號管理"查看） |
| m | 13888888888 | String | 是 | 登錄賬號 |
| t | 1644483577 | String | 是 | 當前時間戳 |
| sign | 07110eb9eb5a21fe83ba561246813627 | String | 是 | "ApiKey+8b795683fb9485430ce84ceb78cda9786d564150+UID+登錄賬號+當前時間戳"拼接后進行32位md5加密 （ApiKey在"會員中心"→"賬號管理"查看） |
| data | [{"tracking_number":"4320579563215","code":"1234","pickup_address":"廣州市天河區天河路1號"}] | String | 是 | 取件碼數據列表，JSON字符串格式，每個元素包含tracking_number(原單號)、code(取件碼)和pickup_address(取件地址，可選) |
響應示例
成功響應示例
{
"success": true,
"code": 200,
"message": "成功更新 2 條記錄",
"data": {
"total": 2, //總數據條數
"success_count": 1, //成功更新數量
"failed_count": 1, //更新失敗數量
"failed_items": [ //更新失敗的項目
{
"tracking_number": "4320579563215", //原單號
"reason": "未找到匹配的訂單或已經更新過該取件碼" //失敗原因
}
],
"error_items": [ //數據驗證失敗的項目
{
"index": 2, //數據索引
"reason": "原單號和取件碼不能為空", //失敗原因
"data": { //原始數據
"tracking_number": "",
"code": "1-2-9012"
}
}
]
}
}失敗響應示例
{
"success": false,
"code": 400,
"message": "沒有接收到有效的導入數據"
}更新第二段上家單號 更新時間：2025-08-12 15:37:00
基本信息
- 溫馨提示： 下面URL的域名為開發時本地測試用，實際使用時須更改為對接網站域名！
- 接口URL：
http://127.0.0.11:8086/apiv2/update_second_tracking_number.html - 請求方式：
POST - Content-Type：
application/x-www-form-urlencoded
請求參數
body參數及說明
| 參數名 | 示例值 | 參數類型 | 是否必填 | 參數描述 |
|---|---|---|---|---|
| u | 90000 | String | 是 | UID（在"會員中心"→"賬號管理"查看） |
| m | 13888888888 | String | 是 | 登錄賬號 |
| t | 1644483577 | String | 是 | 當前時間戳 |
| sign | 07110eb9eb5a21fe83ba561246813627 | String | 是 | "ApiKey+8b795683fb9485430ce84ceb78cda9786d564150+UID+登錄賬號+當前時間戳"拼接后進行32位md5加密 （ApiKey在"會員中心"→"賬號管理"查看） |
| data | [{"waybill_no":"6501121642869","second_tracking_number":"123456"},{"waybill_no":"78851689352816","second_tracking_number":"123456789015"},{"waybill_no":"78870189802691","second_tracking_number":"123456789014"}] | String | 是 | 第二段上家單號數據列表，JSON字符串格式，每個元素包含waybill_no(快遞單號 在購買或查詢接口返回的單號)和second_tracking_number(第二段上家單號) |
響應示例
成功響應示例
{
"success": true,
"code": 200,
"message": "成功更新 1 條記錄",
"data": {
"total": 3, //總數據條數
"success_count": 1, //成功更新數量
"failed_count": 2, //更新失敗數量
"failed_items": [ //更新失敗的項目
{
"index": 1, //數據索引
"waybill_no": "78851689352816", //快遞單號
"reason": "未找到匹配的訂單或已經更新過此訂單的第二段物流單號" //失敗原因
},
{
"index": 2,
"waybill_no": "78870189802691",
"reason": "未找到匹配的訂單或已經更新過此訂單的第二段物流單號"
}
],
"error_items": [] //數據驗證失敗的項目
}
}失敗響應示例
{
"success": false,
"code": 400,
"message": "沒有接收到有效的導入數據"
}