快遞鳥 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
非官方。無利益關係。
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
github: https://github.com/menduo/kdniao_python
oschina: https://git.oschina.net/menduo/kdniao_python