2022年淘宝交易类API .pdf

《2022年淘宝交易类API .pdf》由会员分享，可在线阅读，更多相关《2022年淘宝交易类API .pdf（10页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、淘宝交易类 API 用户 API 数据结构User: 用户Location : 用户地址UserCredit: 用户信用 API列表taobao.user.get: 获取单个用户信息taobao.users.get: 获取多个用户信息产品 API 数据结构Product : 产品结构ProductImg : 产品图片ProductPropImg : 产品属性图片 API列表taobao.product.get: 获取一个产品的信息taobao.products.search : 搜索产品信息taobao.product.add : 上传一个产品，不包括产品非主图和属性图片taobao.prod

2、uct.img.upload: 上传单张产品非主图，如果需要传多张，可调多次taobao.product.propimg.upload: 上传单张产品属性图片，如果需要传多张，可调多次taobao.product.update: 修改一个产品，可以修改主图，不能修改子图片taobao.products.get : 获取产品列表taobao.product.img.delete : 删除产品非主图taobao.product.propimg.delete : 删除产品属性图类目属性 API 数据结构ItemCat : 商品类目ItemProp : 商品属性PropValue : 属性值名师资料总

3、结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页，共 10 页 - - - - - - - - - Brand: 品牌SellerAuthorize: 授权品牌列表和类目列表 API列表taobao.itempropvalues.get: 获取标准类目属性值taobao.itemcats.authorize.get: 查询 B商家被授权品牌列表和类目列表taobao.itemcats.get: 获取后台供卖家发布商品的标准商品类目taobao.itemprops.get : 获取标准商品

4、类目属性商品 API 数据结构Item :商品结构Video : 商品视频结构ItemSearch : 商品搜索结构ItemCategory :商品查询分类结果ItemImg : 商品图片结构PropImg: 商品属性图片结构Sku:Sku 结构Postage : 运费模板结构PostageMode: 运费方式模板收费方式 API列表taobao.items.get: 搜索商品信息（返回值没有ItemCategory ）taobao.items.search: 搜 索 商 品 全 部 信 息 （ 返 回 值 有ItemCategory ）taobao.items.onsale.get : 得到

5、当前会话用户出售中的商品列表taobao.items.inventory.get: 得到当前会话用户库存中的商品列表taobao.items.all.get : 得到当前会话用户的商品列表taobao.item.get : 得到单个商品信息taobao.item.update: 更新商品信息taobao.item.add : 添加一个商品taobao.item.img.upload : 添加商品图片taobao.item.img.delete : 删除商品图片taobao.item.propimg.delete : 删除属性图片taobao.item.propimg.upload : 添加或修

6、改属性图片taobao.item.sku.add : 添加 SKU taobao.item.sku.get : 获取 SKU taobao.item.sku.update : 更新 SKU信息taobao.item.skus.get: 根据卖家昵称和商品ID 列表获取SKU名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页，共 10 页 - - - - - - - - - 信息taobao.item.update.delisting : 商品下架taobao.item.updat

7、e.listing : 一口价商品上架taobao.postages.get: 获取卖家的运费模板taobao.postage.add: 添加邮费模板taobao.postage.update: 修改邮费模板taobao.postage.get: 获取单个运费模板taobao.postage.delete: 删除邮费模板taobao.items.custom.get:根据外部ID 取商品taobao.skus.custom.get: 根据外部ID 取商品 SKU taobao.item.recommend.delete : 取消橱窗推荐一个商品taobao.item.recommend.add

8、 : 橱窗推荐一个商品淘宝客 API 数据结构TaobaokeItem : 淘宝客商品TaobaokeShop: 淘宝客店铺TaobaokeReport : 淘宝客报表TaobaokeReportMember: 淘宝客报表成员 API列表taobao.taobaoke.items.get: 淘宝客商品查询taobao.taobaoke.items.convert: 淘宝客商品转换taobao.taobaoke.shops.convert: 淘宝客店铺转换taobao.taobaoke.listurl.get: 淘宝客关键字搜索URL taobao.taobaoke.caturl.get: 淘宝

9、客类目推广URL获取taobao.taobaoke.report.get: 淘宝客报表查询交易 API 数据结构Trade: 交易结构Order : 订单结构Refund: 退款结构RefundRemindTimeout : 退款超时结构TradeConfirmFee : 确认收货费用结构RefundMessage: 留言 / 凭证数据结构 API列表taobao.trades.bought.get: 搜索当前会话用户作为买家达成的交易记录taobao.trades.sold.get: 搜索当前会话用户作为卖家已卖出名师资料总结 - - -精品资料欢迎下载 - - - - - - - - -

10、- - - - - - - - - 名师精心整理 - - - - - - - 第 3 页，共 10 页 - - - - - - - - - 的交易数据taobao.trades.sold.increment.get: 搜索当前会话用户作为卖家已卖出的增量交易数据taobao.trade.get: 获取单笔交易的部分信息( 性能高 ) taobao.trade.fullinfo.get: 获取单笔交易的详细信息taobao.trade.close: 卖家关闭一笔交易taobao.trade.memo.add: 添加一笔登录用户为买家或卖家的备注taobao.trade.memo.update:

11、修改一笔登录用户为买家或卖家的备注taobao.refunds.apply.get: 查询买家申请的退款列表taobao.refunds.receive.get: 查询卖家收到的退款列表taobao.refund.get: 查询单笔退款详情taobao.trade.confirmfee.get: 获取交易确认收货费用taobao.refund.message.add: 创建退款留言/凭证taobao.refund.messages.get: 退款留言 / 凭证列表查询taobao.trade.snapshot.get: 交易快照查询taobao.trade.ordersku.update: 更

12、新交易订单的销售属性taobao.trade.shippingaddress.update: 更改交易的收货地址评价 API 数据结构TradeRate : 评价信息 API列表taobao.traderates.get: 搜索评价信息taobao.traderate.add: 新增单个评价taobao.traderate.list.add: 针对父子订单新增批量评价物流 API 数据结构Shipping : 物流数据结构LogisticCompany : 物流公司结构Area:地址区域结构 API列表taobao.areas.get: 查询标准地区码panies.get: 查询物流公司信息t

13、aobao.delivery.send: 发货处理taobao.logistics.orders.get: 批量查询物流订单名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页，共 10 页 - - - - - - - - - taobao.logistics.orders.detail.get: 批量查询物流订单, 返回详细信息店铺 API 数据结构Shop: 店铺信息ShopCat: 店铺类目SellerCat: 店铺内卖家自定义类目 API列表taobao.shop.get:

14、 获取卖家店铺的基本信息taobao.shop.update: 更新店铺基本信息taobao.shopcats.list.get: 获取前台展示的店铺类目taobao.sellercats.list.get: 获取前台展示的店铺内卖家自定义商品类目taobao.sellercats.list.add: 添加卖家自定义类目taobao.sellercats.list.update: 更新卖家自定义类目淘宝 SNS类 API （系统级参数v=2.0 ）数据结构Poke: Poke信息SpaceUser: 用户信息Feed: feed(动态 ) 详细信息SpacePicture: 图片信息Space

15、Album: 相册信息Favorite: 兴趣Icon ：用户头像信息Mission : 应用任务MissionVar : 任务特殊属性，各个任务逻辑判断不同的特殊配置属性 API列表江湖系统和通用错误代码定义taobao.jianghu.pokes.getPokeInfoList : 获得默认的动作列表，如果列表为空，只返回根节点taobao.jianghu.poke.poke2User : 向一个用户发起动作taobao.jianghu.albums.getAlbumList : 获得某个用户的相册列表taobao.jianghu.pictures.getPictureList: 根据相册

16、 Id 取获得某个用户的照片列表名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页，共 10 页 - - - - - - - - - taobao.jianghu.picture.uploadPicture : 上传照片到用户的相册taobao.jianghu.feed.publish : 发布一个Feed（动态）taobao.jianghu.feeds.query : 查询 Feed（动态）taobao.jianghu.msg.publish : 发送普通消息（以ISV 应用身

17、份发送）taobao.jianghu.msg.publishSys : 发送系统消息（以官方小淘气身份发送，此接口调用需要高级社区权限）taobao.jianghu.userstatus.updateUserStatus : 更新用户的应用状态taobao.jianghu.customdata.updateCustomData : 更新导航菜单上的用户应用数据taobao.jianghu.user.getProfile : 取得社区用户基本信息taobao.jianghu.users.getProfileList : 批量获取社区用户基本信息taobao.jianghu.friends.get

18、FriendList : 查找用户好友列表taobao.jianghu.friends.areFriends : 判断两个是否为好友taobao.jianghu.coins.consume : 兑换淘金币taobao.jianghu.coins.sum : 查找个人淘金币数taobao.jianghu.coins.add: 增加淘金币taobao.jianghu.missions.get: 取得属于某个app 的，用户领取过而未完成的任务列表taobao.jianghu.mission.finish : 执行完成 app 任务的操作taobao.jianghu.mission.get : 取得

19、属于某个app 的某个具体任务taobao.jianghu.picture.get : 根据 ID 查询单个图片信息淘宝箱 API 数据结构UserSubscribe : 用户订购信息 API列表taobao.appstore.subscribe.get : 查询appstore （淘宝箱）应用订购关系图片空间 API 数据结构Picture: 图片PictureCategory: 图片分类 API列表taobao.picture.upload : 上传一张图片taobao.picture.delete : 删除一张图片taobao.picture.get : 查询图片taobao.pictu

20、re.category.get : 查询图片分类名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页，共 10 页 - - - - - - - - - API1.0 文档API1.0 文档链接地址API1.0 文档API 测试工具使用指南API 测试工具 ，数据环境分为：测试、正式。一、在测试环境下使用API 测试工具须注意3点：1、测试环境下的数据都是公用的测试数据，不能与线上数据混淆。2、当访问一个 访问级别 为 须用户登录 ，或须获取访问级别为 隐私数据须用户登录的 隐 私

21、数 据 时 ， 就 需 要sessionkey 。 在 测 试 环 境 下 获 取SessionKey ， 见 如 何 获 取sessionkey? 。3、可以自定义App Key ，用自己申请的App Key 和 App Secret来测试。二、在正式环境下使用API 测试工具须注意3点：1、正式环境下的数据都是真实的数据。2、用系统默认的App Key 测试时，通过点击“绑定用户”并用商家账号登录淘宝网来获取 SessionKey ， SessionKey 有效时间为半个小时。如果要换商家测试，那么再次点击“绑定用户”重新获取SessionKey 即可。绑定成功后，点击“提交测试”。3、用

22、自定义的App Key 和 App Secret测试时，在正式环境下获取SessionKey ，见 如何获取 sessionkey? 。API 属性工具使用指南API 属性工具 ，它的主要功能是生成商品属性(props) 、销售属性 (sku_properties)、自定义类目属性(input_pids)和自定义属性值(input_str)。首先， 选择商品类目，然后填写属性表单，最后点击“提交”就生成各种属性串了。带*的为商品的必须属性，生成的属性串可作为访问API 的参数。通用约定需要条件需要去 我的工作台注册成为ISV，并创建新应用, 获取app_key和app_secret API 系

23、统参数名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 7 页，共 10 页 - - - - - - - - - 名称类型是否必需描述method String Y API 接口名称。如taobao.item.get。session String N 用户会话码。无需用户登录的时候可以不传。timestamp String Y 时间戳，格式为yyyy-mm-dd hh:mm:ss，例如：2008-01-25 20:23:30 。淘宝 API 服务端允许客户端请求时间误差为10分钟。fo

24、rmat String N 响应格式。 xml,json 。app_key String Y API 应用的 标志符 。v String Y API 接口版本号。signString Y 签名。生成步骤见sign注意事项所有的请求和响应数据编码皆为utf-8 格式，url里的所有参数值最好请做urlencode编码 （ 防 止 中 文 内 容 传 输 过 程 中 乱 码 ）。 如 果HTTP 请 求 的Content-Type是application/x-www-form-urlencoded， http body里的所有参数值也做urlencode编码；如果是 multipart/form-

25、data格式，每个表单字段的参数值无需urlencode编码，当然必须为 utf-8编码，同时每个表单字段的charset部分需要指定为utf-8。api 请求和响应内的日期格式都为yyyy-MM-dd HH:mm:ss或者 yyyy-MM-dd HH:mm:ss.SSS 。钟点格式是 24小时制，例如：2008-03-12 18:23:43。api 请求的 v 参数目前仅为 1.0 。api 请求的 format参数可选值为json,xml,默认 xml。支持分页的api,page_size默认为 40,page_no 默认为 1。支持分页的api的page_size参数上限，除了taoba

26、o.trades.get,taobao.trades.bought.get,taobao.trades.sold.get为100外，其他的皆为 200。所有更新数据操作的api( 如 taobao.item.add和 taobao.item.update)强制使用http post 方法（包括multipart/form-data类型） ,查询类不限制。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 8 页，共 10 页 - - - - - - - - - 列表查询类响应格式以 ta

27、obao.items.get(搜索商品信息 ) 此列表 API 为例正常的返回结果：XML数据格式 2 bedb36c31f895512820363913119bc0d . bedb36c31f895512820363913119bc0d . JSON数据格式rsp:totalResults:2, items:iid:bedb36c31f895512820363913119bc0d, ., iid:b13aa83c8ec35337a1b2e514d6312ba5, . 查询数量为零时返回结果：XML数据格式 JSON数据格式rsp: 错误响应格式XML数据格式 error code error

28、 message JSON数据格式error_rsp:code:error code,msg:error message 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 9 页，共 10 页 - - - - - - - - - taobao.taobaoke.caturl.get 淘宝客类目推广URL taobao.taobaoke.interval.report.get 淘宝客实时报表查询taobao.taobaoke.items.convert 淘客商品转换taobao.taobaoke.items.detail.get 查询淘宝客推广商品详细信息taobao.taobaoke.items.get 查询淘宝客推广商品taobao.taobaoke.listurl.get 淘宝客关键词搜索URL taobao.taobaoke.report.get 淘宝客报表查询名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 10 页，共 10 页 - - - - - - - - -