淘宝客API/SDK介绍总帖

帮你快速概览联盟API、SDK，如何获得权限，及如何使用！

淘宝客API功能开放给在联盟平台完成备案的淘宝客使用，SDK目前为百川电商SDK。

【导航站】

一、请先了解API调用的方式

二、淘宝联盟提供哪些API/SDK服务

三、如何获取权限

四、FAQ

————————————————————————————
一、请先了解api调用的方式：

淘宝客API调用，必须完成媒体备案，创建推广位（即pid）之后，才可生成appkey，进行API调用。

说明：

1、pid如何生成：

淘宝客需先完成媒体备案，在对应媒体ID下，创建推广位。点击了解《淘宝客推广者备案新手指南》

2、pid的三段数字含义：

淘宝客pid由三段数字组成 pid=mm_1_2_3（其中1/2/3分别代表一串数字，举例pid=mm_98836808_12970065_68140878），其中1这串数字对应淘宝客的账户id(通常称member)；2这串数字对应媒体备案管理中的媒体ID(通常称site)；3这串数字对应媒体ID下的具体推广位(通常称adzone)。

3、哪些媒体ID可获得appkey：

媒体备案中，除了“线下-个人、单门店”、、“站内达人平台自动生成的site”这几类媒体ID之外，其他均可申请appkey，每一个媒体ID对应生成一个appkey（一一对应），调用api时系统会校验是否应用于对应媒体阵地内。如果appkey不匹配或传递参数错误，会不算淘宝客交易，切记!

二、淘宝联盟提供哪些API/SDK服务？

能力地图概况

赋能对象：推广者

1、物料类能力

2、基建类能力

①唤端联动(唤醒/授权免登)

需通过百川电商SDK实现唤端、授权免登，百川电商SDK申请入口：https://baichuan.taobao.com/product/esdk.htm?spm=a3c0d.7662652.1998907869.3.100abe48ToF8Iw

②转链类

以下为邀约制

3、组织管理类

①、私域用户管理

1-1：渠道管理：提供淘宝客发展帮助自己推广的渠道，并对其进行管理的能力。

如需申请【点击功能介绍及申请帖】

1-2：会员运营管理：提供帮助淘宝客沉淀自己的会员，进行精准的二次营销、会员管理和营销返利等服务的能力。

如需申请【点击功能介绍及申请帖】

以上两者统一的API权限包：

填写申请表时，提交appkey，即可默认获得，同时还可默认获得两个订单权限包淘宝客【推广者】推广订单及数据查询+淘宝客【推广者】处罚订单查询

私域用户管理规范：https://rule.alimama.com/#!/product/index?type=detailid=405knowledgeId=9350

《私域用户管理能力之新手指南（for媒体）》

4、数据类能力

①拉新数据

基础：默认可申请

②订单明细数据

③淘口令回流数据

5、营销类能力

淘礼金功能权限申请：联盟APP—>我的—>营销工具—>淘礼金。申请规则【请点击】

三、如何获取权限

1、完成阿里妈妈账号注册、完成推广阵地的备案后，可进入淘宝联盟开放平台申请API权限：

淘宝联盟开放平台：https://aff-open.taobao.com/

从该平台中可对默认开放API直接申请，若API邀请制，需要和联盟商务/运营沟通业务场景。

若有相关问题，可在淘宝联盟开放平台顶部的“答疑中心”提交工单咨询。

百川SDK获取权限：唤端、授权免登功能：https://baichuan.taobao.com/product/esdk.htm?spm=a3c0d.7662652.1998907869.3.100abe48ToF8Iw

2、准入及清退规则：

准入规则：符合以下标准的 淘宝客推广者可以申请：

①、须为阿里妈妈激活会员，并绑定符合阿里妈妈要求的支付宝账户。

②、阿里妈妈账户内因特定类型的淘宝客违规而产生的生效中的累计扣分＜18分。解读

③、账户对应的关联账号未在阿里妈妈存在历史违规作弊情形。

清退规则：出现以下情节，阿里妈妈将禁止调用API权限或终止该推广者的API使用权限，因此导致的推广内容无法展现、收入无法统计支取等由推广者自行负责。

①、不符合API权限包开放规则。

②、拥有api权限的推广者连续30天对应API无调用量或无成交量。解读

③、拥有高级API权限(即邀约制API)的媒体，月日均点击量小于5万或月日均alipay金额小于10万。

④、申请的api权限用于非申请时提供的媒体备案渠道内，或未经阿里妈妈事先同意擅自开放给第三方进行调用。

⑤、随意删减、修改淘宝客API接口，或调用淘宝客API接口用以开发插件类应用或依附于客户端（含浏览器）的插件。

⑥、泄露淘宝客API权限的用户名和密码等隐私信息。

⑦、违反《阿里妈妈推广者规范》其他规范的。

3、获取步骤：

① 在阿里妈妈后台备案并审核通过，即可点击“APPKEY申请”去联盟开放平台创建appkey

②进入淘宝联盟开放平台后，点击右上角“新建应用”，选择对应的媒体备案，基于该媒体备案生成appkye（媒体备案id与appkey一一对应），appkey生成后，即可在联盟开放平台中看到对应的权限包和所包含的API，默认开通的可自助申请，高级权限在基础开放条件上为邀约制，小二会根据媒体的发展情况，邀约达成合作意向后开通。

四、FAQ

1、API的调用量是多少？

答：目前单一api没有调用量的限制，但是TOP平台对APP证书的调用量进行了限制，为10W/天。媒体可以进入自己的TOP平台进行查询，当日调用量超过90%时，可申请自助提升调用量（提升量仅当日有效）路径：

2、API怎么用呢？

答：建议可以参考api使用说明文档https://open.taobao.com/doc2/docIndex.htm

3、API的secret是否可以给别人？

答：appkey和secret请不要随意给与他方使用，所有调用都为本淘宝客账号使用，若他方恶意调用，会影响本淘宝客的API调用权限。

4、如果API使用有问题，该如何找到客服？

答：API相关任何使用问题，均可在网站有上交的“工单支持”中提交工单，会有专人处理回复。

5、淘宝联盟开放平台的能力地图如何查看？

淘宝联盟开放平台主页：https://aff-open.taobao.com/ 或从淘宝联盟PC主页点击过去