對於開發者:
- 申請成為開發者
- 創建一個應用,會得到應用的App key和App Secret,其中App Key是公開的,而App Secret是只有開發者才知道的。
用戶如何使用:
- 查詢不需要驗證的非私密信息,如在淘寶不需要登錄就能看到的,可以直接調用API查詢
- 查詢需要驗證的私密信息如交易信息:
1)用戶登錄Taobao,授權我們的應用可以查詢他的私密信息,授權后會得到Session Key
其實這一步需要兩步完成:
a)訪問http://my.open.taobao.com/auth/authorize.htm?appkey={app key}獲得授權碼authcode(有10分鍾時間限制)
b)訪問http://container.open.taobao.com/container?authcode={a獲取的authcode}獲取Session Key
2) 將此Session Key復制到我們的程序中,程序調用TOP時傳入此Session Key就可以返回查詢結果了
C#調用
- 下載.net開發使用的官方SDK(開源的)
- 引用其中的TopSdk.dll
- 基本調用代碼如下:
ITopClient client =
new DefaultTopClient(
"
http://gw.api.taobao.com/router/rest
",
"
appkey
",
"
app secret
");
UserGetRequest req = new UserGetRequest();
// 要查詢的字段
req.Fields = " user_id,uid,nick,sex,buyer_credit,seller_credit,location,created " ;
req.Nick = " test ";
UserGetResponse user = client.Execute(req); // 必要時傳入Session key
UserGetRequest req = new UserGetRequest();
// 要查詢的字段
req.Fields = " user_id,uid,nick,sex,buyer_credit,seller_credit,location,created " ;
req.Nick = " test ";
UserGetResponse user = client.Execute(req); // 必要時傳入Session key
我的實踐總結:
我創建的是商家自用型應用,我是用來自動發貨用的,例如提取買家留言中的Email地址,自動發送郵件給買家。當然采用C/s結構,值得注意的是:Session Key並沒有傳說中的10分鍾限制,可以一次獲取永久使用,也許是商家自用型應用的關系?
