注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 接入指南

一、API测试工具

 API测试工具,数据环境为正式环境(包括应用正式测试环境、上线运行)。API测试工具链接

1、在正式环境下使用API测试工具须注意4点

1)当访问一个访问级别为“须用户登录",或须获取访问级别为"须用户登录"的隐私数据时,就需要sessionkey,见用户授权

2)正式环境下的数据都是真实的数据,调用API时(update,add,create,delete 等) API都会影响店铺数据。

3)用系统默认的App Key测试时,通过点击“获取授权”并用商家账号登录淘宝网来获取SessionKey,SessionKey有效时间为半个小时。如果要换商家测试,那么再次点击“获取授权”重新获取SessionKey即可。获取授权的sessionKey之后,入参对应的API业务数据点击提交测试即可。注意:点击“获取授权”会授权给“淘宝开放平台官方测试工具”应用。

4)用自定义的App Key和App Secret测试时,在正式环境下获取SessionKey,见如何获取sessionkey

【界面预览】

2、常见问题:

1)参数传入错误。一般是蓝色星号表示几个参数中必填一个。红色星号的参数为必传参数。还可能传入参数格式或者类型不对。错误排查参考错误码一览文档所有FAQ

2)点击提交测试没反应。清除缓存或者换浏览器,但少数接口确实需要一定时间才能生成返回结果,如taobao.trades.sold.get 搜索当前会话用户作为卖家已卖出的交易数据。

 二、商品属性工具 

商品属性工具,它的主要功能是生成商品属性(props)、销售属性(sku_properties)、自 定义类目属性(input_pids)和自定义属性值(input_str)。首先,选择商品类目,然后填写属性表单,最后点击“生成属性”就生成各种属性串 了。带*的为商品的必须属性,生成的属性串可作为访问API的参数。属性工具链接 点击查看  注意获取数据时 可能会比较慢,请耐心等待

1、界面预览

 

 

2、使用介绍

 

数据环境为正式环境数据。商品类目,可用taobao.itemcats.get 获取后台供卖家发布商品的标准商品类目获取。关键属性和销售属性以及非关键属性可用taobao.itemprops.get 获取标准商品类目属性获取。填选好相关参数点击生成属性就可以生成相关参数。显示在右边生成参数区域。一般用于发布产品和商品发布  天猫商品使用Schema规则处理,淘宝商品使用taobao.item.add进行处理。

三、错误码排查工具                                                                  

通过API 名称和错误信息,可以快速定位错误原因,从而可以帮助ISV自己快速解决调用TOP接口过程中遇到的问题。访问地址: 查看 。
                                                                                                                                                                                                              

1、操作步骤                                  

输入API名称(必填)和错误码(或者请求TOP获取完整的错误信息),点击查询按钮,获取到具体的错误信息

                                     

2、执行逻辑

1)只输入API名称,返回该API下所有的业务错误码信息。

2)输入API名称和具体的错误码(错误body),返回该API下具体的错误码信息。

3)如果未搜索到,提示未找到改错误信息。TOP会定期扫描,补充错误码信息。                                                     

3、具体示例

1)只输入API名称,返回该API下所有的业务错误码信息。

                                    

2)输入API名称按完整错误查询或者错误码查询,返回该API下具体的错误码信息。

                       

      

四、用户授权工具

1、工具介绍

用户授权工具主要提供给开发者测试使用,开发者在未完成登入授权的流程  需要获取用户的授权进行API测试 即可使用该工具进行获取用户授权及sessionKey参数

2、操作步骤

1)先登陆需要授权的卖家账号。(登陆的淘宝账号是谁获取的数据就是谁的)

2)输入需要授权到的应用appkey ,点击登陆并授权。

3)授权成功出现如下页面,session就是调用接口需要使用的sessionkey(accesstoken)。

五、APP访问日志工具

1、工具介绍

该工具主要提供给开发者查询最近七天的API调用日志。

2、主要功能

1)输入对应的appkey进行查询7天内某一时间的API调用记录(appkey必须是当前登入账号下的,且查询时appkey为必填参数);

2)输入对应的API名称进行查询调用日志;

3)输入对应的用户Nick进行查询调用日志;

4)输入requestID进行查询该条调用的日志;

5)输入对应的调用IP进行查询调用的日志;

6)输入对应的错误码进行查询调用日志。

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部