Download to read offline
调用示例
- 1. 淘宝平台使用REST协议，与编程语言无关。所以只要能够封装一个符合top规范的url做一次http请求就可以取得淘宝的数据。<br />调用入口<br />正式环境：http://gw.api.taobao.com/router/rest<br />沙箱环境：http://gw.sandbox.taobao.com/router/rest<br />注：淘宝沙箱测试环境是淘宝开放平台（TOP）提供给独立软件开发商的测试环境。沙箱环境模拟线上真实的淘宝环境，淘宝商家可以在沙箱环境中完全仿真测试TOP接口的功能；沙箱测试环境地址：http://www.tbsandbox.com/<br />系统参数介绍<br />名称 类型 是否必需 描述methodstringYAPI接口名称sessionstring可选TOP分配给用户的SessionKey，如果需要访问用户隐私数据必选timestampstringY时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2008-01-25 20:23:30。淘宝API服务端允许客户端请求时间误差为10分钟(授权码10分钟有效期)。formatstringN 可选，指定响应格式。默认xml,目前支持格式为xml,jsonapp_keystringYTOP分配给应用的AppKeyvstringYAPI协议版本，可选值:2.0。signstringYAPI输入参数签名结果sign_methodstringY参数的加密方法选择，可选值是：md5,hmac<br />签名<br />根据参数名称将你的所有请求参数按照字母先后顺序排序:key + value .... key + value <br />value对除签名和图片外的所有请求参数按key做的升序排列, value无需编码。 <br />例如：将foo=1,bar=2,baz=3 排序为bar=2,baz=3,foo=1 <br />参数名和参数值链接后，得到拼装字符串bar2baz3foo1<br />1算法<br />系统同时支持MD5和HMAC两种加密方式<br />md5:将secretcode同时拼接到参数字符串头、尾部进行md5加密，再转化成大写，格式 是：byte2hex (md5(secretkey1value1key2value2...secret))。<br />hmac：采用hmac的md5方式，secret code只在头部的签名后,再转化成大写，格式 是：byte2hex (hmac(key1value1key2value2..., secret))。<br />注：hex为自定义方法，JAVA中MD5是对字节数组加密，加密结果是16字节，我们需要的是32位的大写字符串。<br />2实例<br />调用API：taobao.item.get，使用系统默认MD5为例,因为各语言语法不一致，以下实例只体现逻辑,使用appkey=test appsecret=test<br />输入参数为：<br />method=taobao.item.get<br />timestamp=2010-06-20 17:51:30<br />format=xml<br />session=194227da7a2f0e577b999300bbfaa4a070c04<br />app_key=test<br />v=2.0<br />fields=desc<br />nick=测试帐号<br />num_iid= 5159315527<br />sign_method=md5<br />按照参数名称升序排列<br />app_key=test<br />fields=desc<br />format=xml<br />method=taobao.item.get<br />num_iid= 5159315527<br />nick=测试帐号<br />session=194227da7a2f0e577b999300bbfaa4a070c04<br />sign_method=md5<br />timestamp=2010-06-20 17:51:30<br />v=2.0<br />生成sign<br />拼装字符串:连接参数名与参数值,并在首尾加上app_secret(这里假设appsecret=test)值:<br />testapp_keytestfieldsdescformatxmlmethodtaobao.item.getnum_iid5159315527nick测试帐号session194227da7a2f0e577b999300bbfaa4a070c04sign_methodmd5timestamp2010-06-20 17:51:30v2.0test<br />得到32位大写MD5值: 4216F8C43B501B889A823BB9E2797EEF<br />发送http请求<br />拼装URL: 将所有参数值转换为UTF-8编码，然后拼装<br />http://gw.api.taobao.com/router/rest?app_key=test&fields=desc&format=xml&method=taobao.item.get&num_iid=5159315527&nick=hz0799&session=194227da7a2f0e577b999300bbfaa4a070c04&sign=4216F8C43B501B889A823BB9E2797EEF ×tamp=2010-06-20+17%3A51%3A30&v=2.0<br />注意事项<br />所有的请求和响应数据编码皆为utf-8格式，url里的所有参数值请做urlencode编码。如果请求的Content-Type是application/x-www-form-urlencoded， http body里的所有参数值也做urlencode编码；如果是multipart/form-data格式，每个表单字段的参数值无需编码,但每个表单字段的charset部分需要指定为utf-8<br />