淘宝客开发知识 开发前准备与基础知识
- 1).必须有自己的网站，可以自己开发或者是网上购买，不过目前没有提供官方的淘宝客网站。（如无网站请参考我的起步申请免费域名与空间测试）
- 2).必须要有实名认证的淘宝账号。有了这个淘宝账号，你才可以进入到正式环境，上线运行。然后另一个目的就是通过你的淘宝客网站购买的商品，商品佣金会进入这个账户绑定的支付宝。
- 3).淘宝客最关心的是佣金问题，主要看你的淘宝客链接里的pid是否和阿里妈妈里的淘宝pid是否相同。查看阿里妈妈淘宝pid步骤：用淘宝账号登陆阿里妈妈--->我的联盟--->右下方--->获取淘宝客pid
- 4).淘宝客与阿里妈妈淘宝网以及淘宝开发平台的关系。 我的案例 www.qtcrm.com
- Appkey：淘宝开放平台颁发的唯一标识一个应用的ID号，可对外公开。
- Appsecret：应用密钥，不可对外公开，淘宝箱用户需注意保密；调用API的时候需要使用。
- 回调URL：申请WEB应用的时候，必须提供一个回调地址，为应用访问地址即淘客网站。
-
环境功能对比
环境 对比项
开发测试中（沙箱）
正式环境测试（线上数据）
上线运行中（线上数据）
用户隐私数据是否需要session
Y
N
N
是否验证签名
N
Y
Y
权限
有所有API调用权限
受APPKEY权限等级影响
受APPKEY权限等级影响
是否需要审核
注册完成即处在该环境
开发测试环境，点击下一步即可
需小二审核通过方可进入
调用次数、频率限制
无限制
5000次/天
新申请的APPKEY调用频率是100次/分钟，申请的次月会根据APPKEY产生的佣金数据进行调整
-
API调用原理
-
数据获取方式
- 淘宝开放平台提供的API基于REST协议，可兼容多种编程语言。只要能够按照top的规范POST调用参数就可以取得相应接口返回的淘宝数据。
调用入口
- 正式环境：http://gw.api.taobao.com/router/rest
- 沙箱环境：http://gw.api.tbsandbox.com/router/rest
- 注：淘宝沙箱测试环境是淘宝开放平台（TOP）提供给独立软件开发商的测试环境。沙箱环境模拟线上真实的淘宝环境，淘宝商家可以在沙箱环境中完全仿真测试TOP接口的功能；沙箱测试环境地址：http://mini.tbsandbox.com/
系统参数介绍
名称
类型
是否必需
描述
method
string
Y
API接口名称
timestamp
string
Y
时间戳，格式为yyyy-mm-dd HH:mm:ss，例如：2008-01-25 20:23:30。淘宝API服务端允许客户端请求时间误差为10分钟(授权码10分钟有效期)。
format
string
N
可选，指定响应格式。默认xml,目前支持格式为xml,json
app_key
string
Y
TOP分配给应用的AppKey
v
string
Y
API协议版本，可选值:2.0。
sign
string
Y
API输入参数签名结果
sign_method
string
Y
参数的加密方法选择，可选值是：md5,hmac
签名
- 算法
- 根据参数名称将你的所有请求参数按照字母先后顺序排序:key + value .... key + value
- 对除签名和图片外的所有请求参数按key做的升序排列, value无需编码。
- 例如：将foo=1,bar=2,baz=3 排序为bar=2,baz=3,foo=1
- 参数名和参数值链接后，得到拼装字符串bar2baz3foo1
- 系统同时支持MD5和HMAC两种加密方式
- md5：将secretcode同时拼接到参数字符串头、尾部进行md5加密，再转化成大写，格式是：byte2hex (md5(secretkey1value1key2value2...secret))。
- hmac：采用hmac的md5方式，secret code只在头部的签名后,再转化成大写，格式 是：byte2hex (hmac(key1value1key2value2..., secret))。
- 注：hex为自定义方法，JAVA中MD5是对字节数组加密，加密结果是16字节，我们需要的是32位的大写字符串。
- 实例
- 调用API：taobao.taobaoke.items.get，使用系统默认MD5为例,因为各语言语法不一致，以下实例只体现逻辑,使用appkey=test appsecret=test
- 输入参数为：
- method=taobao.taobaoke.items.get
- timestamp=2010-06-20 17:51:30
- format=xml
- app_key=test
- v=2.0
- fields=desc
- nick=测试帐号
- keyword =手机
- sign_method=md5
- 按照参数名称升序排列：
- app_key=test
- fields=desc
- format=xml
- keyword=手机
- method= taobao.taobaoke.items.get
- nick=测试帐号
- sign_method=md5
- timestamp=2010-06-20 17:51:30
- v=2.0
- 拼装字符串：
- 连接参数名与参数值,并在首尾加上app_secret(这里假设appsecret=test)值:
- testapp_keytestfieldsdescformatxmlkeword手机methodtaobao.taobaoke.items.getnick测试帐号sign_methodmd5timestamp2010-06-20 17:51:30v2.0test
- 生成签名：
- 32位大写MD5值->74DFA23F2FDCDA71799D57B97CDA8B5D
发送http请求
- 拼装URL: 将所有参数值转换为UTF-8编码，然后拼装
- http://gw.api.taobao.com/router/rest?app_key=test&fields=desc&format=xml&method=taobao.item.get&keyword=手机&nick=测试帐号& sign= 74DFA23F2FDCDA71799D57B97CDA8B5D ×tamp=2010-06-20+17%3A51%3A30&v=2.0
注意事项
- 所有的请求和响应数据编码皆为utf-8格式，url里的所有参数值请做urlencode编码。如果请求的Content-Type是application/x-www-form-urlencoded， http body里的所有参数值也做urlencode编码；如果是multipart/form-data格式，每个表单字段的参数值无需编码,但每个表单字段的charset部分需要指定为utf-8
常见问题排错方式
- 淘宝客经常遇到的问题就是数据调不出来，页面商品无法显示。鉴于这一点，可以利用测试工具来测试数据。
- 测试工具地址:http://www.taoapi.com
- 1. 选择淘客。
- 2. 任意选择一个淘客接口 例如 ：taobao.taobaoke.items.get
- 3. 填写配置环境参数。选择淘宝正式环境，填写appkey，appsecret。保存。
- 4. 填写参数。保存。
- 5. 显示结果。如果数据能正确返回，说明appkey状态正确。如果不是正确返回，根据错误修改
-
正式环境测试（试运行）
- 当在沙箱环境完成基本功能开发以后，可将APPKEY切换到正式环境下测试。
- 在此环境下测试时，直接影响线上真实数据，请谨慎操作，尤其是批量修改或者删除功能。
上线申请
上线审核规范
审核期间相关规则介绍
- 小二审核期间，应用的调用量与正式环境测试一样，5000/天的限制；淘宝客的审核周期是5-7个工作日
频率控制
- 初次上线的淘宝客应用默认频率控制为100次/分钟
- 上月淘宝客成交金额＞10000，接口调用频率为500/分钟
- 上月淘宝客成交金额＜10000并＞5000，接口调用频率为400/分钟
- 上月淘宝客成交金额＜5000并＞1000，接口调用频率为300/分钟
- 上月淘宝客成交金额＜1000，接口调用频率为200/分钟
- 上月淘宝客成交金额为0，接口调用频率为100/分钟
- 若您觉得您现有的频率控制不能满足您的需求，且您的日佣金超过100元，您可以联系旺旺：察合 来申请更高的频控限制。
我的案例 www.qtcrm.com 希望大家都可以成功上线。
