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