淘宝开发平台TOP API揭秘

TOP API自淘宝开放平台Beta公测开始，陆续开放了上百次个API,这些API涵盖了淘宝基本业务，截止发日志当天TOP-API每天的调用量为：1亿多次。

TOP-API淘宝开放平台Open-API，TOP-API并不是神秘，本文将一层层揭开其面纱，相信通过本日志的表述，作为TOP开发者的您对于TOP-API可以信手拿来，运用自如。想要全面掌握某一项事物，大家肯定想了解what、why、how和plan，本文将围绕这四个方面，整体介绍TOP API，为什么要调用TOP API，怎么调用TOP API和TOP API后续规划。

What？TOP API介绍

TOP API自淘宝开放平台Beta公测开始，陆续开放了上百次个API,这些API涵盖了淘宝基本业务，截止发日志当天TOP API每天的调用量为：1亿多次。针对API的业务、调用角色、访问级别和功能，可进行4个分类。

l 业务分类

l 角色分类

对应角色主要包括：

< < < < <

依次表示公开查询应用、买家应用、卖家应用、商家应用、高级应用、专业应用被授权访问API的角色级别。其中公开查询应用为最低权限集合级别、专业应用为最高权限集合级别。查、买、卖接口无需审批，仅受默认流量规则限制，商家以上接口，淘宝商城用户可以为自己申请商家应用角色。ISV及第三方开发者如需要申请，请看审核规则。

依次表示社区应用、媒体应用、淘宝客应用被授权访问API的角色级别。此三类角色相互独立，并与上述六类角色之间不存在角色依赖关系，可以和上面6种角色叠加使用。

l 访问级别分类

公开: 表示完全公开性的数据接口，主要是查询类的API。 例如：taobao.items.get 。 这类API只需传入appkey+签名进行api的调用。

须用户登录: 表示完全隐私的数据查询接口以及操作性API。 如：taobao.item.add(操作类API） 或 taobao.item.onsale.get（查询）。 这类API调用时，必须传入appkey+sessionkey+签名进行API的调用。

隐私数据须用户登录: 表示部分公开性的数据接口，主要是查询类的API。如：taobao.user.get这个接口。 部分字段是隐私的，部分字段是公开的。当只访问公开数据时，API调用时，只需要传入appkey+签名进行API调用。 当需要访问隐私数据时，需要传入appkey+sessionkey+签名方式来调用。

l API功能分类

普通数据开放 API:目前已经开放的淘宝基本业务数据的Open API。

页面流程化API: 是指将一些复杂的业务流程以页面的形式开放出来。主要包括对安全程度要求较高的页面和业务流程要求统一的页面，如淘宝正向交易和反向交易流程。

增量API:通过该类API，开发者可以获得批量的淘宝变更信息，如商品状态变更和交易状态变更。

Notify API：TOP将相关开发者订阅的操作和变更信息，以主动推送方式通知开发者。

如，淘宝用户信息变更、淘宝类目变更等。

LMS API：任务和统计分析类API，如，任务型批量大量数据查询，统计报表查询类API。

TBML:淘宝模板语言，按理不属于API，之所以罗列出来，是后续为方便开发者业务开发，将复杂麻烦的业务接口以标签形式开放，如，类目和销售属性接口，可组合接口通过一标签语言实现。

Why? TOP API实现业务场景

l 大客户/独立网店

用户：此类型客户其业务经营规模对较大，经营的产品种类、数量较多。但同同类其他企业相比其电子商务方面的信息化程度仍有进一步提高的空间。

市场需求：

1. 由中小网商成长起来的客户为了提高其竞争力，为客户提供独特的购物体验，逐步建立自身的品牌优势， 希望能够建立自己的外部网店。

2. 相对规模较大的成熟企业因为希望提高市场份额、进入新的细分市场、降低销售成本等原因而希望通过电子商务渠道对产品进行推广与销售。

3. 因为建立覆盖企业业务前端(市场、销售)到后端(采购、财务、物流)的整套电子商务系统前期投入较大，且系统实施周期相对较长，对于销售收益前景尚不确定的企业而言是一项风险较大的投资行为。

l 虚拟社区/网络休闲游戏应用

用户：拥有较大用户群体的论坛、社区、网络游戏。

市场需求：

1. 广大论坛、SNS社区渴望将流量变现，与此同时广大商家也期望论坛社区高价值流量能够带来成交和新客户。

2. 厂商希望通过论坛、社区展示其商品信息和购买方式，并促进用户通过简单的操作在论坛、社区上进行即时购买行为。

3. 厂商可以将游戏中的虚拟广告牌、路标、商品换成淘宝客商品，将网游中的道具与实际商品相结合，进行多渠道促销。

l 买家/卖家辅助工具

用户：网商、通过网络进行购物的消费者。

市场需求：

1. 不同种类的商品，不同规模的商家都需要不同的管理工具、店铺展现工具。

2. 普通淘宝买家渴望更好的淘宝购物体验。

How? TOP API开发

目前提供的普通Open API，在调用时，只需要解决签名验证，如果还需要访问用户隐私数据，则还需要用户绑定获得SessionKey。

TOP API采用Rest风格，调用一个接口非常简单，下图为具体调用的数据访问过程。下面举例taobao.items.get接口的调用，将下面链接进行http访问或直接浏览器访问，就可以获得接口的返回值。

http://gw.api.taobao.com/router/rest?app_key=10011201&fields=iid,title,nick,pic_path,cid,price,type,location.city,delist_time,post_fee&format=xml&method=taobao.items.get&q=mp3&timestamp=2009-12-21 20:31:17&v=1.0&sign=67664111FF66F4926EF416DD3F7DE73C

该链接拼装了接口的系统参数和业务参数，系统参数如：app_key（注册应用获得）、format（返回结果格式）、method（调用的接口名称）和timestamp（调用接口时间戳）；应用参数可查看具体的接口的调用参数。

具体调用接口可查看wiki文档—Open API的调用。

Plan? TOP API规划

下面为TOP API的开放业务路线图，发布时间点可能会有所调整，想知道具体发布时间点，请留意TOP论坛公告。