淘宝 API接口

淘宝API接口

之前做项目的时候用到了淘宝API就上网去查了一些，总结了一些，现在分享给大家，希望对大家有帮助，先对淘宝API做个简介吧：

 

•淘宝OpenAPI（Open application programming interface）是一套REST方式的开放应用程序编程接口。淘宝网根据自己提供的电子商务基础服务，抽象并做成一系列的API接口。通过这些接口，可以让外部用户能够通过程序的方式访问淘宝网的数据和平台。淘宝OpenAPI是淘宝开放平台的重要组成部分，是淘宝开放平台三大方向之一——开放业务的主要形式。淘宝OpenAPI又叫TOP（taobao open platform）（下面简称top）

•开发基于openAPI的程序，就是利用淘宝提供的API函数来构造一个URL，通过这个URL去访问淘宝的数据平台，然后服务器会根据你的API返回相应的数据，程序接收到这些数据后再解析并显示出来

 

 

用户接入top流程图：

 

 

 

 

 

 

什么是Appkey和AppSecret：

 

•首先，大家要到官方主页去申请一个appkey，这个是做什么用的呢？App Key是应用的唯一标识，TOP通过App Key来鉴别应用的身份。AppSecret是TOP给应用分配的密钥，开发者需要妥善保存这个密钥，这个密钥用来保证应用来源的的可靠性，防止被伪造。就是说嘛，想要进门可要先有钥匙啊，所以，appkey就是我们进入openAPI大门的钥匙。

 

 

通过官方文档范例总结，开发一个openAPI程序，大致有以下几个步骤：

1 首先构造并调用相应的API函数

2 生成签名

3 组织参数，把API函数构造的URL和签名组合在一起

4 通过该URL访问服务

5 获取服务器返回的数据

6 数据解析，显示

 

 

Taoapi.php文件：

•淘宝API处理类

Taoapi_Cache.php：

•Api 缓存系统

Taoapi_Config.inc.php：

•Api配置文件信息

Taoapi_Config.php

•全局设置参数设置，通过引用Taoapi_Config.inc.php中的配置信息，对信息进行设置和存储

 

Taoapi_Session.php

•Taoapi Session文件，应用程序可通过API获取到淘宝上的用户、交易情况等数据，因为涉及隐私，在使用前必须通过淘宝获得淘宝用户的授权方可调用API(公开数据除外)，而SessionKey则做为用户本次会话的授权标识。应用在获取用户隐私数据时，需要用户授权（Sessionkey）才能获取。

 

 

Taoapi_Util.php

•调用信息的配置，数据请求的解析，HTTP Url 提交文件

 

api_taobao.php：

•API入口操作文件，引用taobaoApi及配置文件，通过函数调用taobaoApi中对应的函数，传入搜索信息获取相应数据

Taoapi_Exception.php：

•淘宝错误处理类，检测API是否遇到错误，错误文件,返回中英错误信息,自动写入日志

 

•文件说明;

1. Taoapi_Config.php 全局性的配置文件,单例模式

•函数:

•setTestMode( ) ：设置API的环境 沙箱或正式

•setVersion () ：设置API版本 1或2

•setAppKey() ：设置appkey

•setAppSecret() ：设置AppSecret

 

2. Taoapi_Cache.php 读写文件缓存文件

•函数:

•setCacheTime()：设置数据缓存的时间,单位:小时;0表示不缓存,不设置默认为 0

•setCachePath()：设置缓存保存的目录.不设置默认为: ./Apicache

 

 

•具体用到哪些函数，要查询TaobaoApi文档

•淘宝API文档中心：http://open.taobao.com/doc/category_list.htm?spm=0.0.0.44.G555re&id=102