Python快遞鳥API接口對接（即時查詢|物流跟蹤|電子面單|單號識別）

快遞鳥 kdniao python sdk, with tornado async & asyncio http client support. https://github.com/menduo/kdniao_python

kdniao_python

快遞鳥 kdniao python sdk, with tornado async http client support.

github: https://github.com/menduo/kdniao_python
oschina: https://git.oschina.net/menduo/kdniao_python
version: 0.1.2
非官方。無利益關系。
前期對接流程：

 

1.登錄快遞鳥注冊快賬號

2.獲取開發者賬號信息（ID ,API Key），登錄快遞鳥后台中查看

 

 

 

 

 

 

 

Screenshot(terminal)

TODO

doc, more doc
test, more test
Support API 支持的快遞鳥 API

即時查詢 http://www.kdniao.com/api-track
物流跟蹤 http://www.kdniao.com/api-follow
電子面單 http://www.kdniao.com/api-eorder
單號識別 http://www.kdniao.com/api-recognise
預約取件 http://www.kdniao.com/api-order
在途監控 http://www.kdniao.com/api-monitor
隱私快遞 http://www.kdniao.com/api-safemail
代收貨款 http://www.kdniao.com/CollectionMoneyAPI.aspx
用戶信息類
注冊 9001
更新 CMD1002
查詢 cmd1003
提交返款銀行信息 CMD1009
查詢返款銀行信息 CMD1008
查詢用戶額度 CMD1014
服務申請類
墊付業務申請 CMD1004
直退業務申請 CMD1005
普通代收貨款申請 CMD1006
查詢服務申請狀態 CMD1007
訂單類
獲取訂單貨款狀態 CMD1010
所有 API 見 http://www.kdniao.com/api-all，快遞鳥可能會隨時推出新的 API。

Install 安裝

pip install -u kdniao

Usage 使用

依賴

無論是在程序上，還是在命令行中，你都必須先獲得快遞鳥官方分配給你的 app id 及 app key。可在 http://www.kdniao.com/reg注冊獲取。

在命令行運行 kdniao命令時，需要在命令行參數中指定 id 與key，或者預先在環境變量中指定 KDNIAO_APP_ID及 KDNIAO_APP_KEY。如：

KDNIAO_APP_ID={你的ID} KDNIAO_APP_KEY={你的Key} kdniao {運單號}，或：
在 ~/.bash_profile中設置變量，並重新打開 shell 執行: kdniao {運單號}，或:
kdniao {運單號} --ik={APP_ID},{APP_KEY}
Command Line 命令行

$ kdniao {運單號} --s=快遞公司編碼 --o=訂單號 --ik={APP_ID},{APP_KEY}

如：

$ kdniao 12345678 --s YTO

$ kdniao 12345678 --ik={APP_ID},{APP_KEY}

Sync 同步客戶端

from kdniao.client import KdNiaoClient
app_id = 12345678
app_key = “YOUR_APP_KEY”
is_prod = True

logistic_code, shipper_code, order_code = 12345678, “SF”, “”

client = KdNiaoClient(app_id, app_key, is_prod)
trace_res = client.api_track.track(logistic_code, shipper_code, order_code, timeout=(10, 10))

Your logic code here

Tornado Async Client 異步客戶端

from kdniao.client import KdNiaoAsyncClient
app_id = 12345678
app_key = “YOUR_APP_KEY”
is_prod = True

logistic_code, shipper_code, order_code = 12345678, “SF”, “”

async_client = KdNiaoAsyncClient(app_id, app_key, is_prod)
trace_res = yield async_client.api_track.track(logistic_code, shipper_code, order_code, timeout=(10, 10))

Your logic code here

貢獻

歡迎 start、fork 並貢獻代碼。也歡迎討論交流、指正。

免責聲明

快遞鳥官方 可能會隨時推出新的 API，kdniao_python未必會及時支持。
快遞鳥官方 可能會隨時變動 API 協議，包括 API 網址、參數、簽名算法等。
相關鏈接

快遞鳥官網：http://www.kdniao.com/
快遞鳥官網 API 列表：http://www.kdniao.com/api-all
聯系

shimenduo AT gmail DOT com