淘宝错误一览表

错误码一览表

简介

• 1，目前开发者调用API可能出现的错误有四类：连接淘宝服务器错误、平台级错误、业务级错误和容器类错误。这四种类型的错误分别代表了开发者访问淘宝服务器、淘宝接入平台、后端业务和容器这几个层次上出现的问题。
• 2，连接淘宝服务器错误主要是http连接错误或者连接被重置被拒绝等，这类错误是开发者访问淘宝服务器出现的问题，请直接联系服务器管理员或通过网络搜索答案。

平台级错误

• 1，平台级错误是指错误码小于100的调用错误，这种错误一般是由于用户的请求不符合各种基本校验而引起的。
• 2，用户遇到这些错误的返回首先检查应用的权限、频率等情况，然后参照文档检验一下传入的参数是否完整且合法。

错误码 错误描述-英文 错误描述-中文 解决方案 3 Upload Fail 图片上传失败 将传入的图片格式改为正确的格式、适当的大小的图片放进消息体里面传输过来，如果传输仍然失败需要减小图片大小或者增加网络带宽进行尝试 7 App Call Limited 应用调用次数超限，包含调用频率超限 调整程序合理调用API，等限频时间过了再调用，淘客的调用频率是系统按照上个月交易额自动修改的，修改后的频率会在官方论坛首页以公告形式通知，开发者可自行查看 9 Http Action Not Allowed HTTP方法被禁止 请用大写的POST或GET，如果有图片等信息传入则一定要用POST才可以 10 Service Currently Unavailable 服务不可用 多数是由未知异常引起的，仔细检查传入的参数是否符合文档描述 11 Insufficient ISV Permissions 开发者权限不足 应用没有权限调用中级或高级权限的接口，可在淘宝合作伙伴后台提交权限申请 12 Insufficient User Permissions 用户权限不足 应用没有权限调用中级或高级权限的接口，可在淘宝合作伙伴后台提交权限申请 13 Insufficient Partner Permissions 合作伙伴权限不足 应用没有权限调用中级或高级权限的接口，可在淘宝合作伙伴后台提交权限申请 15 Remote Service Error 远程服务出错 API调用后端服务出错，首先查看自己的参数是否合法，如果参数没有问题请过一段时间再尝试 21 Missing Method 缺少方法名参数 传入的参数加入method字段 22 Invalid Method 不存在的方法名 传入的method字段必需是你所调用的API的名称，并且该API是确实存在的 23 Invalid Format 无效数据格式 传入的format必需为json或xml中的一种 24 Missing Signature 缺少签名参数 传入的参数中必需包含sign字段 25 Invalid Signature 无效签名 签名必需根据正确的算法算出来的。算法请见： http://open.taobao.com/dev/index.php/API签名算法 26 Missing Session 缺少SessionKey参数 传入的参数中必需包含session字段 27 Invalid Session 无效的SessionKey参数 传入的session必需是用户绑定session拿到的，如果报session不合法可能是用户没有绑定session或session过期造成的，用户需要重新绑定一下然后传入新的sessionKey 28 Missing App Key 缺少AppKey参数 传入的参数必需包含app_key字段 29 Invalid App Key 无效的AppKey参数 应用所处的环境跟选择的环境不一致，例如：应用处于沙箱测试环境，却选择在正式环境进行测试,可在合作伙伴后台或商家接入平台对该应用进行修改 30 Missing Timestamp 缺少时间戳参数 传入的参数中必需包含timestamp参数 31 Invalid Timestamp 非法的时间戳参数 时间戳，格式为yyyy-mm-dd hh:mm:ss，例如：2008-01-25 20:23:30。淘宝API服务端允许客户端请求时间误差为10分钟 32 Missing Version 缺少版本参数 传入的参数中必需包含v字段 33 Invalid Version 非法的版本参数 用户传入的版本号格式错误，必需为数字格式 34 Unsupported Version 不支持的版本号 用户传入的版本号没有被提供 40 Missing Required Arguments 缺少必选参数 API文档中设置为必选的参数是必传的，请仔细核对文档 41 Invalid Arguments 非法的参数 参数类型不对，例如：需要传入的是数字类型的，却传入了字符类型的参数 42 Forbidden Request 请求被禁止 目前没有控制 43 Parameter Error 参数错误 一般是用户传入参数非法引起的，请仔细检查入参格式、范围是否一一对应 47 Invalid encoding 编码错误 一般是用户做http请求的时候没有用UTF-8编码请求造成的

业务级错误

• 1，业务级错误是指用户通过平台初步的参数校验，进入后端业务流程所出现的，错误码大于100的错误。
• 2，以isv开头的一般都是isv的错误，这一类错误一般是由于用户提供的参数不合法或者不匹配造成的，因此isv应该根据错误信息检验是否传入了相应的信息，对于这一类错误建议改正后再重试。
• 3，以isp开头的错误一般是isp服务不可用或top平台连接后端服务时的错误，这些错误可能与后台服务端的服务可用性有关，建议用户在一段时间后重试。
• 4，错误响应是用户和服务器交互失败的最直接展示，isv在调用top服务时，如果调用失败，请尽量保留下错误日志以便进行后面的错误追查。

业务级父错误

产品线 错误码 用户 500 类目 510 交易 520 退款 521 商品 530 商品扩展 531 邮费模板 532 产品 540 物流 550 店铺 560 评价 570 淘宝客 580 系统 590 备案 591 增量 600 画报 620 江湖 630 分销 640 淘秀 650 收费 660

业务级子错误

子错误码格式 错误信息 归属方 是否可在程序中重试 isv.###-not-exist:*** 根据***查询不到### ISV 否 isv.missing-parameter:*** 缺少必要的参数*** ISV 否 isv.invalid-paramete:*** 参数***无效，格式不对、非法值、越界等 ISV 否 isv.invalid-permission 权限不够、非法访问 ISV 否 isv.parameters-mismatch:***-and-### 传入的参数***和###不匹配，两者有一定的对应关系 ISV 否 isv.***-service-error:### 调用***服务返回false，业务逻辑错误，###表示具体的错误信息 ISV 否 isp.***-service-unavailable 调用后端服务***抛异常，服务不可用 ISP 是 isp.remote-service-error 连接远程服务错误 ISP 是 isp.remote-service-timeout 连接远程服务超时 ISP 是 isp.remote-connection-error 远程连接错误 ISP 是 isp.null-pointer-exception 空指针异常错误 ISP 否 isp.top-parse-error api解析错误（出现了未被明确控制的异常信息） ISP 否 isp.top-remote-connection-timeout top平台连接后端服务超时 ISP 是 isp.top-remote-connection-error top平台连接后端服务错误，找不到服务 ISP 是 isp.top-mapping-parse-error top-mapping转换出错，主要是由于传入参数格式不对 ISP 否 isp.unknown-error top平台连接后端服务抛未知异常信息 ISP 是

容器类错误

• 容器类错误是指用户通过容器登录之后页面上出现的错误

错误码 错误描述（中文） 100 授权码已经过期 101 授权码在缓存里不存在，一般是用同样的authcode两次获取sessionkey 102 系统错误，建议清理浏览器缓存，稍后重试 103 appkey或者tid（插件ID）参数必须至少传入一个 104 appkey或者tid对应的插件不存在 105 插件的状态不对，不是上线状态或者正式环境下测试状态 106 没权限调用此app，由于插件不是所有用户都默认安装，所以需要用户和插件进行一个订购关系，这个错误一般是由于用户访问了自己没有订购的在线订购应用所造成的 107 系统错误，建议清理浏览器缓存，稍后重试 108 应用是自用型应用，只有自用型绑定用户才可以访问。 109，111 服务端在生成参数的时候出了问题，建议清理浏览器缓存，稍后重试 110 服务端在写出参数的时候出了问题 ，建议清理浏览器缓存，稍后重试 112 回调地址不正确，请检查回调地址，是否为空，或者含有top认为非法的字符。 113 用户没有同意授权

• 其他特有错误码

801 App请求所带的参数错误，一般是缺失必要参数 802 如果协议要求签名，签名错误 803 时间戳校验不过，和服务端时间差距不能超过5分钟