调用原理说明
TOP作为淘宝数据插槽,只要用户按照TOP的规范拼装一个正确的URL,通过HTTP请求到TOP,就能够拿到用户自己需要的数据。调用原理的示意图如下:
3.2使用方式详解
1)参数介绍
API由入参和出参(返回结果)组成,其中入参包含系统级参数和应用级参数。
系统级参数:对于每个API均一致,主要用于加密、标识用户身份、API协议版本等用途。
参数名
类型
是否必须
参数解释
method
string
Y
API接口名称
session
string
N
TOP分配给用户的SessionKey,如果需要访问用户隐私数据必选。
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