淘宝常用API和错误表说明

经常使用的淘宝API

提供了用户基本信息查询功能

数据结构列表UserCredit 用户信用

Location 用户地址

User 用户

API列表
taobao.user.get 获取单个用户信息

taobao.users.get 获取多个用户信息

数据结构列表ItemImg ItemImg结构

ItemCategory 商品查询分类结果

Location 用户地址

ProductPropImg 产品属性图片

AdditionSku 销售附加信息(和库存、价格无关)

ProductImg 产品图片

Product 产品结构

AfterSale 卖家设置售后服务对象

PropImg 商品属性图片结构

ItemTemplate 宝贝详情页面信息

Sku Sku结构

Video 商品视频关联记录

ItemSearch 商品搜索

Item Item(商品)结构

API列表taobao.aftersale.get 查询用户售后服务模板

taobao.item.add 添加一个商品

taobao.item.delete 删除单条商品

taobao.item.get 得到单个商品信息

taobao.item.img.delete 删除商品图片

taobao.item.img.upload 添加商品图片

taobao.item.joint.img 商品关联子图

taobao.item.joint.propimg 商品关联属性图

taobao.item.price.update  更新商品价格

taobao.item.propimg.delete 删除属性图片

taobao.item.propimg.upload 添加或修改属性图片

taobao.item.quantity.update 宝贝/SKU库存修改

taobao.item.recommend.add 橱窗推荐一个商品

taobao.item.recommend.delete 取消橱窗推荐一个商品

taobao.item.sku.add 添加SKU

taobao.item.sku.delete 删除SKU

taobao.item.sku.get 获取SKU

taobao.item.sku.price.update  更新商品SKU的价格

taobao.item.sku.update 更新SKU信息

taobao.item.skus.get 根据商品ID列表获取SKU信息

taobao.item.templates.get 获取用户宝贝详情页模板名称

taobao.item.update 更新商品信息

taobao.item.update.delisting 商品下架

taobao.item.update.listing 一口价商品上架

taobao.items.custom.get 根据外部ID取商品

taobao.items.get 搜索商品信息

taobao.items.inventory.get 得到当前会话用户库存中的商品列表

taobao.items.list.get 批量获取商品信息

taobao.items.onsale.get 获取当前会话用户出售中的商品列表

taobao.items.search 搜索商品信息

taobao.product.add 上传一个产品，不包括产品非主图和属性图片

taobao.product.get 获取一个产品的信息

taobao.product.img.delete 删除产品非主图

taobao.product.img.upload 上传单张产品非主图，如果需要传多张，可调多次

taobao.product.propimg.delete 删除产品属性图

taobao.product.propimg.upload 上传单张产品属性图片，如果需要传多张，可调多次

taobao.product.update 修改一个产品，可以修改主图，不能修改子图片

taobao.products.get 获取产品列表

taobao.products.search 搜索产品信息

taobao.skus.custom.get 根据外部ID取商品SKU 
 
类目API
提供了标准类目，类目属性和类目属性值的查询功能

数据结构列表PropValue 属性值

SellerAuthorize 授权

ItemProp 商品属性

Brand 品牌

ItemCat 商品类目结构

API列表taobao.itemcats.authorize.get 查询B商家被授权品牌列表和类目列表

taobao.itemcats.get 获取后台供卖家发布商品的标准商品类目

taobao.itemprops.get 获取标准商品类目属性

taobao.itempropvalues.get 获取标准类目属性值 
 交易API
提供了订单下载，修改收货地址、修改交易备注等功能

数据结构列表PromotionDetail 交易的优惠信息详情

OrderAmount 子订单的帐务数据结构

Order 订单结构

TradeAmount 交易订单的帐务信息详情

Task 批量异步任务结果

Trade 交易结构

Subtask 批量异步任务的子任务结果

TradeConfirmFee 确认收货费用结构

API列表taobao.topats.result.get 获取异步任务结果

taobao.topats.trade.accountreport.get 异步获取淘宝卖家绑定的支付宝账户的财务明细

taobao.topats.trades.fullinfo.get 异步批量获取交易订单详情api

taobao.trade.amount.get 交易订单帐务查询

taobao.trade.close 卖家关闭一笔交易

taobao.trade.confirmfee.get 获取交易确认收货费用

taobao.trade.fullinfo.get 获取单笔交易的详细信息

taobao.trade.get 获取单笔交易的部分信息(性能高)

taobao.trade.memo.add 对一笔交易添加备注

taobao.trade.memo.update 修改一笔交易备注

taobao.trade.ordersku.update 更新交易订单的销售属性

taobao.trade.postage.update 修改订单邮费价格

taobao.trade.receivetime.delay 延长交易收货时间

taobao.trade.shippingaddress.update 更改交易的收货地址

taobao.trade.snapshot.get 交易快照查询

taobao.trades.bought.get 搜索当前会话用户作为买家达成的交易记录

taobao.trades.sold.get 搜索当前会话用户作为卖家已卖出的交易数据

taobao.trades.sold.increment.get 搜索当前会话用户作为卖家已卖出的增量交易数据
数据结构列表ShopCat 店铺类目

ShopScore 店铺动态评分信息

SellerCat 店铺内卖家自定义类目

Shop 店铺信息

API列表taobao.sellercats.list.add 添加卖家自定义类目

taobao.sellercats.list.get 获取前台展示的店铺内卖家自定义商品类目

taobao.sellercats.list.update 更新卖家自定义类目

taobao.shop.get 获取卖家店铺的基本信息

taobao.shop.remainshowcase.get 获取卖家店铺剩余橱窗数量

taobao.shop.update 更新店铺基本信息

taobao.shopcats.list.get 获取前台展示的店铺类目 
 营销API
提供淘宝营销工具的业务，包括店铺优惠券、会员关系管理等；商家必须已经订购了营销工具才能使用这些接口获取数据。

数据结构列表LimitDiscount 限时打折

CouponDetail 优惠券详细信息

BuyerCouponDetail 买家持有优惠券信息

Activity 活动数据结构

Coupon 优惠券数据结构

Promotion 商品优惠策略详情

Meal 搭配套餐类。

LimitDiscountDetail 限时打折详情

UserTag 人群标签

API列表taobao.marketing.promotion.kfc 定向优惠活动名称与描述违禁词检查

taobao.marketing.promotions.get 查询商品定向优惠策略

taobao.marketing.tags.get 查询人群标签

taobao.promotion.activity.get 查询某个卖家的店铺优惠券领取活动

taobao.promotion.coupon.buyer.search 买家查询当前所有优惠券信息

taobao.promotion.coupondetail.get 通过接口可以查询某个店铺优惠券的买家详细信息

taobao.promotion.coupons.get 查询卖家优惠券

taobao.promotion.limitdiscount.detail.get 限时打折详情查询

taobao.promotion.limitdiscount.get 限时打折查询

taobao.promotion.meal.get 搭配套餐查询

 

系统级错误

错误码 错误描述（英文） 错误描述（中文） 3 Upload Fail 图片上传失败 4 User Call Limited 用户调用次数超限 5 Session Call Limited 会话调用次数超限 6 Partner Call Limited 合作伙伴调用次数超限 7 App Call Limited 应用调用次数超限 8 App Call Exceeds Limited Frequency 应用调用频率超限 9 Http Action Not Allowed HTTP方法被禁止（请用大写的POST或GET） 10 Service Currently Unavailable 服务不可用 11 Insufficient ISV Permissions 开发者权限不足 12 Insufficient User Permissions 用户权限不足 13 Insufficient Partner Permissions 合作伙伴权限不足 15 Remote Service Error 远程服务出错 21 Missing Method 缺少方法名参数 22 Invalid Method 不存在的方法名 23 Invalid Format 非法数据格式 24 Missing Signature 缺少签名参数 25 Invalid Signature 非法签名 26 Missing Session 缺少SessionKey参数 27 Invalid Session 无效的SessionKey参数 28 Missing App Key 缺少AppKey参数 29 Invalid App Key 非法的AppKe参数 30 Missing Timestamp 缺少时间戳参数 31 Invalid Timestamp 非法的时间戳参数 32 Missing Version 缺少版本参数 33 Invalid Version 非法的版本参数 34 Unsupported Version 不支持的版本号 40 Missing Required Arguments 缺少必选参数 41 Invalid Arguments 非法的参数 42 Forbidden Request 请求被禁止 43 Parameter Error 参数错误

业务级错误

错误码 错误描述（英文） 错误描述（中文） 501 Your Statement is Not Indexable 语句不可索引 502 Data Service Unavailable 数据服务不可用 503 Error While Parsing TBQL Statement 无法解释TBQL语句 504 Need Binding User 需要绑定用户昵称 505 Missing Parameters 缺少参数 506 Parameters Error 参数错误 507 Parameters Format Error 参数格式错误 508 No Permission Get Information 获取信息权限不足 550 User Service Unavailable 用户服务不可用 551 Item Service Unavailable 商品服务不可用 552 Item Image Service Unavailable 商品图片服务不可用 553 Item Simple Update Service Unavailable 商品更新服务不可用 554 Item Delete Failure 商品删除失败 555 No Picture Service for User 用户没有订购图片服务 556 Picture URL is Error 图片URL错误 557 Item Media Service Unavailable 商品视频服务不可用 560 Trade Service Unavailable 交易服务不可用 561 Trade TC Service Unavailable 交易服务不可用 562 Trade not Exists 交易不存在 563 Trade is Invalid 非法交易 564 No Permission Add or Update Trade Memo 没有权限添加或更新交易备注 565 Trade Memo Too Long 交易备注超出长度限制 566 Trade Memo Already Exists 交易备注已经存在 567 No Permission Add or Update Trade 没有权限添加或更新交易信息 568 No Detail Order 交易没有子订单 569 Close Trade Error 交易关闭错误 570 Shipping Service Unavailable 物流服务不可用 571 Invalid Post Fee 非法的邮费 572 Invalid Division Code 非法的物流公司编号 580 Rate Service Unavailable 评价服务不可用 581 Rate Service Add Error 添加评价服务错误 582 Rate Service List Error 获取评价服务错误 590 Shop Service Unavailable 店铺服务不可用 591 Shop Showcase Remain Count Unavailable 店铺剩余橱窗推荐服务不可用 592 Shop Seller Category Service Unavailable 卖家自定义类目服务不可用 594 Shop Seller Category Insert Error 卖家自定义类目添加错误 595 Shop Seller Category Update Error 卖家自定义类目更新错误 596 No Shop for This User 用户没有店铺 597 Shop Seller Parent Category Error 卖家自定义父类目错误 540 Trade Stat Service Unavailable 交易统计服务不可用 541 Category Stat Service Unavailable 类目统计服务不可用 542 Item Stat Service Unavailable 商品统计服务不可用 601 User not Exists 用户不存在 610 Product Service Unavailable 产品服务不可用 710 Taobaoke Service Unavailable 淘宝客服务不可用 611 Product Number Format Exception 产品数据格式错误 612 Product ID Incorrect 产品ID错误 613 Product Image Delete Error 删除产品图片错误 614 No Permission to Add Product 没有权限添加产品 615 Delivery Address Service Unavailable 收货地址服务不可用 620 Postage Service Unavailable 邮费服务不可用 621 Postage Mode Type Error 邮费模板类型错误 622 Missing Parameter: post, express or ems 缺少参数：post, express或ems 623 Postage Mode Parameter Error 邮费模板参数错误 630 Combo Service Unavailable 收费服务不可用 650 Refund Service Unavailable 退款服务不可用 651 Refund ID Invalid 非法的退款编号 652 Refund Service Unavailable 退款服务不可用 653 Refund not Exists 退款不存在 654 No Permission to Get Refund 没有权限获取退款信息 655 No Permission to Add Refund Message 没有权限添加退款留言 656 Cannot add Refund Message for STATUS_CLOSED(4) or STATUS_SUCCESS(5) 无法添加退款留言 657 Refund Message Content Too Long 退款留言内容太长 658 Refund Message Content Cannot be NULL 退款留言内容不能为空 659 Biz Order ID is Invalid 非法的交易订单（或子订单）ID 660 Item Extra Service Unavailable 商品扩展服务不可用 661 Item Extra not Exists 商品扩展信息不存在 662 No Permission Update Item Extra 没有权限更新商品扩展信息 663 Shipping Parameter Missing 缺少物流参数 664 Shipping Parameter Error 物流参数错误 670 Commission Service Unavailable 佣金服务不可用 671 Commission Trade not Exists 佣金交易不存在 672 Payment Service Unavailable 淘宝客报表服务不可用 673 ICP Service Unavailable 备案服务不可用 674 App Service Unavailable 应用服务不可用 900 Remote Connection Error 远程连接错误 901 Remote Service Timeout 远程服务超时 902 Remote Service Error 远程服务错误

容器类错误

错误码	错误描述（中文）
100	授权码已经过期
101	授权码在缓存里不存在，一般是用同样的authcode两次获取sessionkey
103	appkey或者tid（插件ID）参数必须至少传入一个
104	appkey或者tid对应的插件不存在
105	插件的状态不对，不是上线状态或者正式环境下测试状态
106	没权限调用此app，由于插件不是所有用户都默认安装，所以需要用户和插件进行一个订购关系。
108	由于app有绑定昵称，而登陆的昵称不是绑定昵称，所以没权限访问。
109，111	服务端在生成参数的时候出了问题（一般是tair有问题）
110	服务端在写出参数的时候出了问题