淘宝开放平台API开发（一）

一、前言

       淘宝官方为应用开发者提供了一套很好的API，开发是只要调用它的API接口就可以获取相应的数据。笔者现正从事Java Web开发，因而就淘宝API调用方法做出一点总结，主要还是对于官方API文档的一些解释与样例的实现。可能会存在较为片面的地方，看客若觉得有什么意见还望提出。

二、开发前期

      我这里指的开发前期工作，主要指的是正式开始编写代码前的一些前期工作，主要包括加入开放平台、创建应用、管理应用等阶段。这些阶段在淘宝开放平台上已经有了非常详细的图文教程，相信读者按照上面的流程认真操作就可以完成这些操作，因此不做过多的赘述。在此假定我们已经完成了应用的创建，并且得到了该应用的App Key和App Secret，如下图所示：

      点击左边导航SDK下载，选择开放平台API SDK（Java版下载），如下图所示，选择生成最新SDK，然后下载，会得到两个jar包，将这两个jar包导入到你的工程中：

      这样，前期的工作基本完成了。

三、API Tools在线测试工具

      API Tools在线测试工具确实是一个很强大的东西，如果我们掌握了如何使用会大大提升我们的开发效率。下面是taobao.products.searh的API测试工具显示：

      taobao.products.search这个API的功能是搜索产品的信息，相当于我们输入一些关键字，它就会按照关键字来尽可能多的返回信息。

       返回格式：有xml和json格式两种，这里我们默认xml，因为在后面看结果的话会清晰一些。

       数据环境：选择正式，因为我们最后还是要在真正的环境下运行

       AppKey和AppSecret：这里最好输入你的应用的key和secret，系统分配有一个问题就是超过次数导致无法使用，而我们自己的key和secret是刚刚申请的，不会有这样的问题。

       fields：这一栏是我们想要API返回的一些信息，如果你想要哪个信息，将它的变量名填入（以逗号隔开）就可以了。

       q、cid、prop：这三个打了蓝色的“*”，说明至少需要填写一个，表示三个不同的关键字，关键字给的越多，搜索越精确。

       其他变量：具体查看API文档定义，用法还是一样的。

       比如说我现在要搜索“衬衫”这个关键字，如下填入参数，由于抓取的数量可能比较多，我们设置page_no为1，page_size为5，也就是只抓取5条，点击提交测试，返回如下：

    我们将返回结果复制出来，保存到XML文件中，显示如下

<?xml version="1.0" encoding="UTF-8"?>

-<products_search_response>

<!--top010178028035.n.et2-->


-<products list="true">


-<product>

<cid>162104</cid>

<name>INC 女装 女式长袖衬衫 Q01216998</name>

<pic_url>http://img03.taobaocdn.com/bao/uploaded/i3/TB1EG25GVXXXXbiXpXX3c0X7VXX_013408.jpg</pic_url>

<product_id>317634545</product_id>

<props>20000:3641086;13021751:767610673</props>

</product>


-<product>

<cid>50014802</cid>

<name>美国直邮Columbia哥伦比亚X477417_10户外男防紫外线短袖衬衫</name>

<pic_url>http://img02.taobaocdn.com/bao/uploaded/i2/TB1IV65GVXXXXbuXpXX2jwN7FXX_013217.jpg</pic_url>

<product_id>316785659</product_id>

<props>20000:27976;13021751:767670300</props>

</product>


-<product>

<cid>50014802</cid>

<name>美国直邮Columbia哥伦比亚X477417_9户外运动男防紫外线短袖衬衫</name>

<pic_url>http://img05.taobaocdn.com/bao/uploaded/i5/TB1hQCMGVXXXXcXXVXXNiIL7FXX_013206.jpg</pic_url>

<product_id>317542591</product_id>

<props>20000:27976;13021751:767710018</props>

</product>


-<product>

<cid>50014802</cid>

<name>美国直邮Columbia哥伦比亚X477417_8户外运动男防紫外线短袖衬衫</name>

<pic_url>http://img04.taobaocdn.com/bao/uploaded/i4/TB1TZT8GVXXXXXLXXXXn7MG7FXX_013151.jpg</pic_url>

<product_id>317800483</product_id>

<props>20000:27976;13021751:767614579</props>

</product>


-<product>

<cid>50014802</cid>

<name>美国直邮Columbia哥伦比亚X477417_7户外运动男防紫外线短袖衬衫</name>

<pic_url>http://img05.taobaocdn.com/bao/uploaded/i5/TB1FHD2GVXXXXcIXFXXwfQE7FXX_013136.jpg</pic_url>

<product_id>317486602</product_id>

<props>20000:27976;13021751:767564989</props>

</product>

</products>

<total_results>1408236</total_results>

</products_search_response>

       可以看出，测试抓去了5条以“衬衫”为关键字的产品，分别列出了它们的相应属性值。再看网站右下角，显示了SDK调用示例代码，我们直接复制到Java代码中就能实现同样的功能，当然这些都是后话。

       在线测试工具还有一个强大的功能就是，当你进行了错误的输入时，它会返回相应的错误给你，让你知道错在哪里，也就是说，这个工具给调试提供了巨大的便利，相信你会喜欢上它。

    （第一篇到此结束，持续更新。。。）