快遞100快遞管家API接口授權(quán)有兩種方式，一種是通過使用者的手機(jī)號授權(quán)，生成一個專屬的新賬號，通過跳轉(zhuǎn)接口跳轉(zhuǎn)到快遞管家進(jìn)行打單，跳轉(zhuǎn)后使用新賬號自動完成登錄；一種是通過使用者現(xiàn)有的快遞100賬號授權(quán)，授權(quán)后仍使用該現(xiàn)有賬號登錄快遞管家進(jìn)行打單。

第一種是手機(jī)號授權(quán)接口，第二種是用戶登錄授權(quán)接口，兩個接口的目的都是為了獲取access_token值再調(diào)用業(yè)務(wù)接口，具體調(diào)用說明如下：
【手機(jī)號授權(quán)接口】
1.接口信息

接口地址	https://b.kuaidi100.com/open/oauth/token
通信協(xié)議	HTTPS
請求方式	POST
字符集	UTF-8
請求Conent-Type	application/x-www-form-urlencoded

2.請求參數(shù)

名稱類型是否必填描述

client_id	String	是	由快遞100提供，接入應(yīng)用的唯一標(biāo)識 ([快遞管家官網(wǎng)API服務(wù)],管理中的App Key)
client_secret	String	是	由快遞100提供，接入應(yīng)用的唯一標(biāo)識 [(快遞管家官網(wǎng)API服務(wù)],管理中的App Secret)
timestamp	long	是	時間戳(自 1970 年 01 月 01 日起到現(xiàn)在的毫秒數(shù))， 例： 1502963129794
grant_type	String	是	固定為client_credentials
sign	String	是	簽名
mobile	String	是	手機(jī)號碼

3.返回參數(shù)

名稱類型是否必填描述

access_token	String	是	可用于調(diào)用 API 的 access_token，有效1年；access_token 失效前可通過refresh_token刷新延長，刷一次延長1年
expires_in	String	是	access_token 的有效時長，單位：秒(過期時間：1年)
refresh_token	String	是	用于延長 access_token 有效時間的刷新令牌
openid	String	是	授權(quán)用戶的openid

接口源文檔地址：https://www.kuaidi100.com/ecommerce/api/index.html?name=11

【用戶登錄授權(quán)接口】

1.請求地址拼接
拼接用戶授權(quán)需訪問 url ，示例及參數(shù)說明如下：
https://b.kuaidi100.com/open/oauth/authorize?response_type=code&client_id=LeWFeuaGwx1v&redirect_uri=http://b.kuaidi100.com/open/test/sent.do&state=test123&timestamp=1533089506853&sign=918D78EF0B180029A52EB6560B03BBDA

公共參數(shù)

名稱類型是否必填描述

client_id	String	是	由快遞100提供，接入應(yīng)用的唯一標(biāo)識 (快遞管家官[網(wǎng)API服務(wù)],管理中的App Key)
response_type	String	是	返回的令牌類型(固定為 “code”)
redirect_uri	String	是	redirect_uri 指的是應(yīng)用發(fā)起請求時，所傳的回調(diào) 地址參數(shù)，在用戶授權(quán)后應(yīng)用會跳轉(zhuǎn)至 redirect_uri。 要求與應(yīng)用注冊時填寫的回調(diào)地址一致
state	Sting	否	維持應(yīng)用的狀態(tài)，返回值與傳入值一致。
timestamp	long	是	時間戳(自1970年01月01日起到現(xiàn)在的毫秒數(shù))， 例：1502963129794
sign	String	是	API輸入?yún)?shù)簽名結(jié)果，簽名算法參照【簽名說明】

2.引導(dǎo)用戶登錄授權(quán)
引導(dǎo)用戶通過瀏覽器(建議使用360瀏覽器)訪問以上授權(quán) url，將彈出如下授權(quán)頁面，用戶輸入賬號信息，點擊“登錄”。

3.獲取 code
用戶點擊“登錄”按鈕后，系統(tǒng)將授權(quán)碼 code 返回到貴方回調(diào)URL上，貴方可以獲取并使用該 code 去換取 access_token；code 有效期 3分鐘，3 分鐘后需要重新授權(quán)，如下圖：

4.換取 access_token
請求方式：POST
Conent-Type：application/x-www-form-urlencoded
請求地址：https://b.kuaidi100.com/open/oauth/accessToken
4.1 請求參數(shù)

名稱類型是否必填描述

client_id	String	是	由快遞100提供，接入應(yīng)用的唯一標(biāo)識 ([快遞管家官網(wǎng)API服務(wù)],管理中的App Key)
client_secret	String	是	由快遞100提供，接入應(yīng)用的唯一標(biāo)識 ([快遞管家官網(wǎng)API服務(wù)],管理中的App Secret)
grant_type	String	是	授與方式(固定為 “authorization_code”)
code	String	是	上一步獲取的 code值
redirect_uri	String	是	redirect_uri 指的是應(yīng)用發(fā)起請求時，所傳的回調(diào)地址 參數(shù)，在用戶授權(quán)后應(yīng)用會跳轉(zhuǎn)至 redirect_uri。 要求與快遞管家API服務(wù)頁面填寫的回調(diào)地址一致
timestamp	long	是	時間戳(自1970年01月01日起到現(xiàn)在的毫秒數(shù))， 例：1502963129794
sign	String	是	API輸入?yún)?shù)簽名結(jié)果，簽名算法參照【簽名說明】

4.2 返回參數(shù)

名稱類型是否必填描述

access_token	String	是	可用于調(diào)用 API 的 access_token，有效1年；access_token 失效前可通過refresh_token刷新延長，刷一次延長1年
expires_in	Long	是	access_token 的有效時長，單位：秒(過期時間：1年)
refresh_token	String	是	用于延長 access_token 有效時間的刷新令牌
openid	String	是	授權(quán)用戶的openid

接口源文檔地址：https://www.kuaidi100.com/ecommerce/api/index.html?name=12

以上兩種方式獲取的access_token值有效期1年，快到期時可重新授權(quán)獲取新的access_token值，或者調(diào)用刷新令牌接口，具體調(diào)用說明如下：
【刷新令牌接口】
1.接口信息

請求地址	https://b.kuaidi100.com/open/oauth/refreshToken
請求方式	POST
Conent-Type	application/x-www-form-urlencoded

2.請求參數(shù)

名稱類型是否必填描述

client_id	String	是	由快遞100提供，接入應(yīng)用的唯一標(biāo)識 ([快遞管家官網(wǎng)API服務(wù)],管理中的App Key)
client_secret	String	是	由快遞100提供，接入應(yīng)用的唯一標(biāo)識 [(快遞管家官網(wǎng)API服務(wù)],管理中的App Secret)
refresh_token	String	是	授權(quán)獲取的 refresh_token
timestamp	long	是	時間戳(自 1970 年 01 月 01 日起到現(xiàn)在的毫秒數(shù))， 例： 1502963129794
grant_type	String	是	固定為refresh_token
sign	String	是	簽名

3.返回參數(shù)

名稱類型是否必填描述

access_token	String	是	可用于調(diào)用 API 的 access_token，有效1年；access_token 失效前可通過refresh_token刷新延長，刷一次延長1年
expires_in	String	是	access_token 的有效時長，單位：秒(過期時間：1年)
refresh_token	String	是	用于延長 access_token 有效時間的刷新令牌
openid	String	是	授權(quán)用戶的openid

接口源文檔地址：https://www.kuaidi100.com/ecommerce/api/index.html?name=13

總結(jié)

以上是生活随笔為你收集整理的对接快递100快递管家API之授权接口的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。