国产xx在线观看,人类之光安布雷拉,中文字幕第12页

實(shí)時(shí)快遞單號(hào)查詢技術(shù)文檔

當(dāng)前位置：點(diǎn)晴教程→知識(shí)管理交流 →『技術(shù)文檔交流』

admin

2022年9月7日 19:57 本文熱度 1038

https://www.kuaidi100.com/

https://api.kuaidi100.com/document/5f0ffb5ebc8da837cbd8aefc#section_2

一、實(shí)時(shí)快遞查詢接口

用戶向接口提交快遞單號(hào)后，接口會(huì)實(shí)時(shí)調(diào)取快遞公司的單號(hào)信息并返回此單號(hào)最新的物流信息，包括物流軌跡、狀態(tài)、時(shí)間等。

注意：請(qǐng)控制每一單查詢頻率至少在半小時(shí)以上，否則會(huì)造成鎖單。

1.1 請(qǐng)求地址

https://poll.kuaidi100.com/poll/query.do

1.2 請(qǐng)求類型

post

1.3 輸入?yún)?shù)

請(qǐng)求參數(shù)（header）

名稱	類型	默認(rèn)值
Content-Type	string	application/x-www-form-urlencoded

請(qǐng)求參數(shù)（body）

名稱	類型	是否必需	示例值	描述
customer	String	是		授權(quán)碼，請(qǐng)申請(qǐng)企業(yè)版獲取
sign	String	是		簽名，用于驗(yàn)證身份，按param + key + customer 的順序進(jìn)行MD5加密（注意加密后字符串一定要轉(zhuǎn)32位大寫），不需要加上“+”號(hào)
Θparam	Object	是		由其他字段拼接
└ com	string	是	yuantong	查詢的快遞公司的編碼，一律用小寫字母下載編碼表格
└ num	string	是	12345678	查詢的快遞單號(hào)，單號(hào)的最小長(zhǎng)度6個(gè)字符，最大長(zhǎng)度32個(gè)字符
└ phone	string	否	13888888888	收、寄件人的電話號(hào)碼（手機(jī)和固定電話均可，只能填寫一個(gè)，順豐速運(yùn)和豐網(wǎng)速運(yùn)必填，其他快遞公司選填。如座機(jī)號(hào)碼有分機(jī)號(hào)，分機(jī)號(hào)無(wú)需傳入。）
└ from	string	否	廣東深圳	出發(fā)地城市
└ to	string	否	北京朝陽(yáng)	目的地城市，到達(dá)目的地后會(huì)加大監(jiān)控頻率
└ resultv2	int	否	1	添加此字段表示開通行政區(qū)域解析功能。空：關(guān)閉（默認(rèn)），1：開通行政區(qū)域解析功能以及物流軌跡增加物流狀態(tài)名稱 4: 開通行政解析功能以及物流軌跡增加物流高級(jí)狀態(tài)名稱、狀態(tài)值并且返回出發(fā)、目的及當(dāng)前城市信息
└show	String	否	0	返回格式：0：json格式（默認(rèn)），1：xml，2：html，3：text
└order	String	否	desc	返回結(jié)果排序:desc降序（默認(rèn)）,asc 升序

1.4 請(qǐng)求參數(shù)示例

customer = **********
sign = ******************
param = {
    "com": "ems",
    "num": "em263999513jp",
    "phone": "13868688888",
    "from": "廣東省深圳市南山區(qū)",
    "to": "北京市朝陽(yáng)區(qū)",
    "resultv2": "4",
    "show": "0",
    "order": "desc"
}

1.5 返回結(jié)果

字段名稱	類型	字段含義
message	String	消息體，請(qǐng)忽略
state	String	快遞單當(dāng)前狀態(tài)，默認(rèn)為0在途，1攬收，2疑難，3簽收，4退簽，5派件，8清關(guān)，14拒簽等10個(gè)基礎(chǔ)物流狀態(tài)，如需要返回高級(jí)物流狀態(tài)，請(qǐng)參考 resultv2 傳值
status	String	通訊狀態(tài)，請(qǐng)忽略
condition	String	快遞單明細(xì)狀態(tài)標(biāo)記，暫未實(shí)現(xiàn)，請(qǐng)忽略
ischeck	String	是否簽收標(biāo)記，0未簽收，1已簽收，請(qǐng)忽略，明細(xì)狀態(tài)請(qǐng)參考state字段
com	String	快遞公司編碼,一律用小寫字母
nu	String	單號(hào)
Θdata	data	最新查詢結(jié)果，數(shù)組，包含多項(xiàng)，全量，倒序（即時(shí)間最新的在最前），每項(xiàng)都是對(duì)象，對(duì)象包含字段請(qǐng)展開
└ context	String	內(nèi)容
└ time	String	時(shí)間，原始格式
└ ftime	String	格式化后時(shí)間
└status	String	本數(shù)據(jù)元對(duì)應(yīng)的物流狀態(tài)名稱或者高級(jí)狀態(tài)名稱，實(shí)時(shí)查詢接口中提交resultv2=1或者resultv2=4標(biāo)記后才會(huì)出現(xiàn)
└statusCode	String	本數(shù)據(jù)元對(duì)應(yīng)的高級(jí)物流狀態(tài)值，實(shí)時(shí)查詢接口中提交resultv2=4標(biāo)記后才會(huì)出現(xiàn)
└areaCode	String	本數(shù)據(jù)元對(duì)應(yīng)的行政區(qū)域的編碼，實(shí)時(shí)查詢接口中提交resultv2=1或者resultv2=4標(biāo)記后才會(huì)出現(xiàn)
└areaName	String	本數(shù)據(jù)元對(duì)應(yīng)的行政區(qū)域的名稱，實(shí)時(shí)查詢接口中提交resultv2=1或者resultv2=4標(biāo)記后才會(huì)出現(xiàn)
└areaCenter	String	本數(shù)據(jù)元對(duì)應(yīng)的行政區(qū)域經(jīng)緯度，實(shí)時(shí)查詢接口中提交resultv2=4標(biāo)記后才會(huì)出現(xiàn)
└location	String	本數(shù)據(jù)元對(duì)應(yīng)的快件當(dāng)前地點(diǎn)，實(shí)時(shí)查詢接口中提交resultv2=4標(biāo)記后才會(huì)出現(xiàn)
└areaPinYin	String	本數(shù)據(jù)元對(duì)應(yīng)的行政區(qū)域拼音，實(shí)時(shí)查詢接口中提交resultv2=4標(biāo)記后才會(huì)出現(xiàn)

1.6 運(yùn)單快遞狀態(tài)（state)說(shuō)明

物流狀態(tài)值	物流狀態(tài)名稱	高級(jí)物流狀態(tài)值	高級(jí)物流狀態(tài)名稱	含義

1	攬收	1	攬收	快件攬件
		101	已下單	已經(jīng)下快件單
		102	待攬收	待快遞公司攬收
		103	已攬收	快遞公司已經(jīng)攬收
0	在途	0	在途	快件在途中
		1001	到達(dá)派件城市	快件到達(dá)收件人城市
		1002	干線	快件處于運(yùn)輸過(guò)程中
		1003	轉(zhuǎn)遞	快件發(fā)往到新的收件地址
5	派件	5	派件	快件正在派件
5	派件	501	投柜或驛站	快件已經(jīng)投遞到快遞柜或者快遞驛站
3	簽收	3	簽收	快件已簽收
		301	本人簽收	收件人正常簽收
		302	派件異常后簽收	快件顯示派件異常，但后續(xù)正常簽收
		303	代簽	快件已被代簽
		304	投柜或站簽收	快件已從快遞柜或者驛站取出簽收
6	退回	6	退回	快件正處于返回發(fā)貨人的途中
4	退簽	4	退簽	此快件單已退簽
		401	已銷單	此快件單已撤銷
		14	拒簽	收件人拒簽快件
7	轉(zhuǎn)投	7	轉(zhuǎn)投	快件轉(zhuǎn)給其他快遞公司郵寄
2	疑難	2	疑難	快件存在疑難
		201	超時(shí)未簽收	快件長(zhǎng)時(shí)間派件后未簽收
		202	超時(shí)未更新	快件長(zhǎng)時(shí)間沒(méi)有派件或簽收
		203	拒收	收件人發(fā)起拒收快遞,待發(fā)貨方確認(rèn)
		204	派件異常	快件派件時(shí)遇到異常情況
		205	柜或驛站超時(shí)未取	快件在快遞柜或者驛站長(zhǎng)時(shí)間未取
		206	無(wú)法聯(lián)系	無(wú)法聯(lián)系到收件人
		207	超區(qū)	超出快遞公司的服務(wù)區(qū)范圍
		208	滯留	快件滯留在網(wǎng)點(diǎn)，沒(méi)有派送
		209	破損	快件破損
8	清關(guān)	8	清關(guān)	快件清關(guān)
		10	待清關(guān)	快件等待清關(guān)
		11	清關(guān)中	快件正在清關(guān)流程中
		12	已清關(guān)	快件已完成清關(guān)流程
		13	清關(guān)異常	貨物在清關(guān)過(guò)程中出現(xiàn)異常
14	拒簽	\	\	收件人拒簽快件

注：如需物流狀態(tài)高級(jí)狀態(tài)名稱及狀態(tài)值需要 resultv2 傳 “4” 返回

1.7 正確返回示例

JSON格式

{
    "message": "ok",
    "nu": "JT0004301991791",
    "ischeck": "0",
    "com": "jtexpress",
    "status": "200",
    "data": [
        {
            "time": "2021-12-15 17:19:28",
            "context": "【杭州市】您的包裹已存放至【驛站】，記得早點(diǎn)來(lái)取它回家！",
            "ftime": "2021-12-15 17:19:28",
            "areaCode": "CN330102000000",//本數(shù)據(jù)元對(duì)應(yīng)的行政區(qū)域編碼，resultv2=1或者resultv2=4才會(huì)展示
            "areaName": "浙江,杭州市,上城區(qū)",//本數(shù)據(jù)元對(duì)應(yīng)的行政區(qū)域名稱，resultv2=1或者resultv2=4才會(huì)展示
            "status": "投柜或驛站",//本數(shù)據(jù)元對(duì)應(yīng)的物流狀態(tài)名稱或者高級(jí)物流狀態(tài)名稱，resultv2=1或者resultv2=4才會(huì)展示
            "location": "浙江省 杭州市 上城區(qū)", //本數(shù)據(jù)元對(duì)應(yīng)的快件當(dāng)前地點(diǎn)，resultv2=4才會(huì)展示
            "areaCenter": "120.184349,30.25446", //本數(shù)據(jù)元對(duì)應(yīng)的行政區(qū)域經(jīng)緯度，resultv2=4才會(huì)展示
            "areaPinYin": "shang cheng qu",//本數(shù)據(jù)元對(duì)應(yīng)的行政區(qū)域拼音，resultv2=4才會(huì)展示
            "statusCode": "501"//本數(shù)據(jù)元對(duì)應(yīng)的高級(jí)物流狀態(tài)值，resultv2=4才會(huì)展示
        },
        {
            "time": "2021-12-15 14:17:31",
            "context": "【杭州市】【杭州網(wǎng)點(diǎn)】的極兔小哥正在派件",
            "ftime": "2021-12-15 14:17:31",
            "areaCode": "CN330102000000",
            "areaName": "浙江,杭州市,上城區(qū)",
            "status": "派件",
            "location": "浙江省 杭州市 上城區(qū)",
            "areaCenter": "120.184349,30.25446",
            "areaPinYin": "shang cheng qu",
            "statusCode": "5"
        },
        {
            "time": "2021-12-15 13:58:18",
            "context": "【杭州市】 快件到達(dá)【杭州網(wǎng)點(diǎn)】",
            "ftime": "2021-12-15 13:58:18",
            "areaCode": "CN330102000000",
            "areaName": "浙江,杭州市,上城區(qū)",
            "status": "在途",
            "location": "浙江省 杭州市 上城區(qū)",
            "areaCenter": "120.184349,30.25446",
            "areaPinYin": "shang cheng qu",
            "statusCode": "0"
        },
        {
            "time": "2021-12-15 04:11:20",
            "context": "【杭州市】快件離開【杭州轉(zhuǎn)運(yùn)中心】已發(fā)往【杭州江干四季青網(wǎng)點(diǎn)】",
            "ftime": "2021-12-15 04:11:20",
            "areaCode": "CN330109000000",
            "areaName": "浙江,杭州市,蕭山區(qū)",
            "status": "干線",
            "location": "浙江省 杭州市 蕭山區(qū)",
            "areaCenter": "120.493286,30.28333",
            "areaPinYin": "xiao shan qu",
            "statusCode": "1002"
        },
        {
            "time": "2021-12-15 02:09:52",
            "context": "【杭州市】 快件到達(dá)【杭州轉(zhuǎn)運(yùn)中心】",
            "ftime": "2021-12-15 02:09:52",
            "areaCode": "CN330109000000",
            "areaName": "浙江,杭州市,蕭山區(qū)",
            "status": "干線",
            "location": "浙江省 杭州市 蕭山區(qū)",
            "areaCenter": "120.493286,30.28333",
            "areaPinYin": "xiao shan qu",
            "statusCode": "1002"
        },
        {
            "time": "2021-12-14 21:08:34",
            "context": "【上海市】快件離開【上海浦西轉(zhuǎn)運(yùn)中心】已發(fā)往【杭州轉(zhuǎn)運(yùn)中心】",
            "ftime": "2021-12-14 21:08:34",
            "areaCode": "CN310118000000",
            "areaName": "上海,上海,青浦區(qū)",
            "status": "干線",
            "location": "上海 上海市 青浦區(qū)",
            "areaCenter": "121.124178,31.150681",
            "areaPinYin": "qing pu qu",
            "statusCode": "1002"
        },
        {
            "time": "2021-12-14 20:54:22",
            "context": "【上海市】 快件到達(dá)【上海浦西轉(zhuǎn)運(yùn)中心】",
            "ftime": "2021-12-14 20:54:22",
            "areaCode": "CN310118000000",
            "areaName": "上海,上海,青浦區(qū)",
            "status": "干線",
            "location": "上海 上海市 青浦區(qū)",
            "areaCenter": "121.124178,31.150681",
            "areaPinYin": "qing pu qu",
            "statusCode": "1002"
        },
        {
            "time": "2021-12-14 17:25:58",
            "context": "【上海市】快件離開【上海楊浦黃興路網(wǎng)點(diǎn)】已發(fā)往【上海浦西轉(zhuǎn)運(yùn)中心】",
            "ftime": "2021-12-14 17:25:58",
            "areaCode": "CN310110000000",
            "areaName": "上海,上海,楊浦區(qū)",
            "status": "干線",
            "location": "上海 上海市 楊浦區(qū)",
            "areaCenter": "121.526077,31.259541",
            "areaPinYin": "yang pu qu",
            "statusCode": "1002"
        },
        {
            "time": "2021-12-14 09:03:58",
            "context": "【上海市】【上海楊浦黃興路網(wǎng)點(diǎn)】已取件。",
            "ftime": "2021-12-14 09:03:58",
            "areaCode": "CN310110000000",
            "areaName": "上海,上海,楊浦區(qū)",
            "status": "攬收",
            "location": "上海 上海市 楊浦區(qū)",
            "areaCenter": "121.526077,31.259541",
            "areaPinYin": "yang pu qu",
            "statusCode": "1"
        }
    ],
    "state": "5",
    "condition": "00",
    "routeInfo": {
        "from": {
            "number": "CN310110000000",
            "name": "上海,上海,楊浦區(qū)"
        },//本數(shù)據(jù)元對(duì)應(yīng)的出發(fā)地城市信息，resultv2=4才會(huì)展示
        "cur": {
            "number": "CN330102000000",
            "name": "浙江,杭州市,上城區(qū)"
        },//本數(shù)據(jù)元對(duì)應(yīng)的當(dāng)前城市信息，resultv2=4才會(huì)展示
        "to": null
    },//本數(shù)據(jù)元對(duì)應(yīng)的目的地城市信息，resultv2=4才會(huì)展示
    "isLoop": false
}
}

1.8 錯(cuò)誤返回示例

JSON格式

{
    "result": false,
    "returnCode": "400",
    "message": "找不到對(duì)應(yīng)公司"
}

1.8 信息代碼含義

信息代碼	信息內(nèi)容描述	原因及建議處理方式
200	查詢成功	查詢成功
400	找不到對(duì)應(yīng)公司	提交數(shù)據(jù)不完整或者賬號(hào)未充值, 檢查提交的格式是否為x-www-form-urlencoded的post格式
500	查詢無(wú)結(jié)果，請(qǐng)隔段時(shí)間再查	表示查詢失敗，或沒(méi)有POST提交
501	服務(wù)器錯(cuò)誤	快遞100的服務(wù)器出現(xiàn)間歇或臨時(shí)性異常，有時(shí)如果因?yàn)椴话匆?guī)范提交請(qǐng)求，比如快遞公司參數(shù)沒(méi)有按照文檔規(guī)定填寫等，也會(huì)報(bào)此錯(cuò)誤
502	服務(wù)器繁忙	快遞100的服務(wù)器出現(xiàn)間歇或臨時(shí)性異常，請(qǐng)聯(lián)系快遞100排查原因
503	驗(yàn)證簽名失敗	請(qǐng)檢查加密方式，param + key + customer 的順序進(jìn)行MD5加密，加密后字符串轉(zhuǎn)大寫
601	key已過(guò)期	沒(méi)有可用單量，賬號(hào)需要充值使用

二、快遞公司編碼

下載表格

如果您需要的公司不在此列表，請(qǐng)聯(lián)系在線客服添加

三、demo下載

JAVA示例代碼 PHP示例代碼 PYTHON示例代碼 .NET示例代碼

四、注意事項(xiàng)

1、貴司連續(xù)5次com字段為空或者不符合《快遞100快遞公司編碼規(guī)則》，快遞100API將會(huì)通過(guò)快遞單號(hào)的數(shù)據(jù)自動(dòng)調(diào)用智能識(shí)別接口，判斷合適的快遞公司編號(hào)，返回對(duì)應(yīng)的快遞信息。

2、貴司com字段數(shù)據(jù)符合《快遞100快遞公司編碼規(guī)則》時(shí)，同一錯(cuò)誤快遞單號(hào)連續(xù)調(diào)用接口5次，快遞100API接口將返回500（查詢無(wú)結(jié)果，請(qǐng)隔段時(shí)間再查）。需要注意的是：該次調(diào)用的單號(hào)會(huì)列入貴司的調(diào)用數(shù)據(jù)內(nèi)，列入計(jì)費(fèi)賬單內(nèi)。

該文章在 2022/9/7 19:57:53 編輯過(guò)

關(guān)鍵字查詢