对于开发者:
- 申请成为开发者
- 创建一个应用,会得到应用的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分钟限制,可以一次获取永久使用,也许是商家自用型应用的关系?