top错误诊断简要说明

1、Evaluation Warning: The document was created with Spire.Doc for .NET.一、 错错误处理理流程概概览从这个错错误处理理流程可可知，在在整个错错误处理理的过程程中，一一共可以以分为33条主要要的流程程：请求求解析异异常流程程处理，平台级级错误处处理和业务调调用错误误处理。当当然，这这一切处处理的最最初也是是最重要要的一步步就是：将服务务器响应应内容保保留下来来。二、 服服务器响响应内容容透析服务器响应应内容，顾顾名思义义就是iisv调调用toop服务务得到的的响应的的内容。这这些内容容能够最最真实的反反应出issv请求求的问题题和

2、服务务器当前前的情况况，也最最能够帮帮助issv找到到问题的的所在。服务器响应应内容一一般分为为两种：一种是是wikki文档档中所编编写的成成功调用用所返回回的字段段，另一一种是调调用失败败的返回回的错误误相关信信息。1. 调调用成功功返回格格式调用成功的的响应信信息内容容根据调调用服务务版本的的不同分分为了两两种不同同的格式式。1.0的服服务返回回信息的的格式分分为三层层：最外外一层是是rssp: 标记，表表示这是是服务的的响应内内容；中中间一层层是返回回结构体体的标记记，如：返回的的是商品品的结构构体，中中间这层层就是iteems: , ，表示结果果是一个个商品的的列表，如如果返回回参数不

3、不是以结结构体的的形式，这这一层就就不存在在；最内内一层就就是每个个结构体体具体的的字段了了。1.0这个个版本所所有返回回结果，不不论是单单个的商商品还是是一个商商品列表表，他的的第二层层都是一一个列表表的结构构，区别别只是列列表里有有一个子子结构体体还是有有多个子子结构体体而已。相比之下，2.0的服务返回信息就相对的规范化了。2.0的响应内容主要也可以分为3层：最外一层是你调用服务的名称所对应的响应标记，如：获取单个商品（taobao.item.get）的响应最外层为item_get_response: ，表示这是获取单个商品的响应；中间一层是返回结构体的标记。如果结构体是单个，那么2.0返

4、回的这一层里面就会是单个的结构，如：获取的单个商品的结构体就是item: ；反之，如果结构体是多个，那么列表也会明显的表示出来，如：搜索商品列表的结构体就会是”items”:“item”: , 。最外层的items表示这是一个商品的列表，后面的item表示列表中的每一个子结构体都是属于商品item的，然后就跟着商品的数据；最内一层就商品的具体字段信息了。2. 调调用错误误返回当调用发生生错误的的时候，一般情情况下可可以分为为几大类类错误信信息的返返回：hhttpp连接错错误、平平台解析析错误、业业务处理理错误。这这三种类类型的错错误分别别代表了了：淘宝宝服务器器、淘宝宝接入平平台、ttop-a

5、pii业务，几几个层次次上出现现的问题题。1) hhttpp连接错错误http连连接错误误是请求求通信过过程中出出现的错错误，这这类型错错误通常常由htttp响响应码标标记出来来。htttp响响应码由由三位十十进制数数字组成成，它们们出现在在由HTTTP服服务器发发送的响响应的第第一行。响应码分五五种类型型，由它它们的第第一位数数字表示示：1xx：信信息，请请求收到到，继续续处理2xx：成成功，行行为被成成功地接接受、理理解和采采纳3xx：重重定向，为为了完成成请求，必必须进一一步执行行的动作作4xx：客客户端错错误，请请求包含含语法错错误或者者请求无无法实现现5xx：服服务器错错误，服服务器

6、不不能实现现一种明明显无效效的请求求Isv调用用topp服务最最常收到到就是2200：htttp请求求成功；4044：未找找到请求求的服务务；5000内部部服务器器错误等等等。如如果用户户收到的的响应码码是4004，表表示用户户的网络络有问题题或者ttop被被和谐了了如果用用户收到到的响应应码是5500，表表示网络络是okk的，是是top的服务务无法响响应。2) 服服务端错错误总述述平台解析错错误和业业务处理理错误都都是htttp成成功访问问到topp服务（htttp响应应码返回回为2000）之后所所产生的的错信息息，他们们topp处理isv请求求过程中中出现的的问题。1.0和2.0的格式有所

7、不同。1.0的错错误响应应信息最最外层为为“errror_rspp”: ,表示这这是调用用错误所所返回的的信息。里里面一层层包含两两个元素素：”codde”:” ”和 “msg”:” ”，前者者表示错错误码是是多少，后后者表示示错误信信息是什什么。例例如错误误的调用用1.00的taoobaoo.ittem.gett服务错错误时返返回的错错误信息息：errror_rspp:coode:400,mmsg:MMisssingg reequiiredd arrgummentts:mmisssingg paarammeteer iiid/numm_iiid。这个信息的的开头为为errror_rspp，表

8、示示这是调调用错误误所返回回的结果果。里面面包含的的错误体体的coode为为40，是是平台型型错误，表表示错误误是缺少少了必传传参数所所引起的的。然后后msgg内容为为Misssinng rrequuireed aarguumennts:misssinng pparaametter iidd/nuum_iiid，表表示缺少少的必传传参数是是iidd或者nuum_iiid。Isvv解析到到这些信信息后就就需要根根据错误误信息改改进自己己传入的的参数来来使调用用成功。2.0的错错误响应应信息的的最外层层为“errror_ressponnse”:” ”，表示示这是调调用服务务失败所所返回的的错误信信

9、息。信信息体里里面一层层总共包包含了五五个元素素：aargss:arrg:“key”:“ ”,”vallue”:” ”,“key”:“ ”,”vallue”:” ”,“key”:“ ”,”vallue”:” ”，”codde”:” ”， “msg”:” ”，”subb_coode”:” ”和”subb_mssg”:” ”。arggs表示示用户传传入的参参数列表表是什么么，里面面是一个个argg的列表表会包含含用户传传入的所所有参数数信息，每每个arg表示示一个参参数的信息，keey表示示参数的的名称，value表示参数的内容，用以方便用户定位自己的错误；code表示用户调用错误的错误码是多少，

10、小于200表示平台级错误，200-1000之间表示大范围的业务错误，即哪一类型的api调用发生了错误（根据api的大类来分，如：商品类的api是530，交易类的api是520，等）；msg表示大类型的错误码所对应的错误信息，一般不具备独立的debug作用，需要和sub_code和sub_msg一起使用才行；sub_code是调用错误的子错误码，他表示用户调用错误的原因；sub_msg是子错误码所对应的错误信息，他用来补充细化子错误码的错误原因的。例如调用2.0的taobao.item.get服务错误时返回的错误信息：errror_ressponnse:arggs:aarg:keey:appp_

11、kkey,vvaluue:1557399,kkey:ffiellds,vvaluue:liist_timme,ddeliist_timme,aapprrovee_sttatuus,keyy:forrmatt,vallue:jjsonn,kkey:mmethhod,vvaluue:ttaobbao.iteem.gget,keey:niick,vvaluue:tbbtesst5661,keyy:parrtneer_iid,vaaluee:TOPPTESST,keyy:siggn,vaaluee:6688FB44A0449F771A11C8445EFF8C005B11F3EE66,keey:tiim

12、esstammp,vaaluee:20110-003-005 118:003:006.3325,keey:v,vvaluue:2.0,coode:5330,msgg:Remmote serrvicce eerroor,suub_ccodee:misssinng-pparaametter,ssub_msgg:iidd和numm_iiid至少少要传入入一个这个信息的的开头为为errror_ressponnse，表表示这是是调用错错误所返返回的错错误信息息。里面面的arrgs列列出了用用调用这这个接口口传入的的信息有有：keey:appp_kkey,vvaluue:1557399,kkey:ffie

13、llds,vvaluue:liist_timme,ddeliist_timme,aapprrovee_sttatuus,keyy:forrmatt,vallue:jjsonn,kkey:mmethhod,vvaluue:taaobaao.iitemm.geet,keyy:nicck,vaaluee:tbttestt5611,kkey:pparttnerr_idd,vallue:TTOPTTESTT,kkey:ssignn,vallue:6668FFB4AA0499F711A1CC8455EF88C055B1FF3E666,keyy:timmesttampp,vallue:220100-033-

14、055 188:033:066.3225,keyy:v,vaaluee:2.00，这些些信息是是从用户户的请求求信息里里面解析析出来的的。错误误码coode为为5300，表示示这是调调用商品品的appi所产产生的错错误。错错误信息息msgg为Remmotee seerviice errror表表示这是是调用业业务处理理所产生生的错误误。子错错误码ssub_codde为：misssinng-pparaametter，表表示这个个错误是是因为缺缺少了参参数所产产生的。子子错误信信息suub_mmsg为为：iiid和numm_iiid至少少要传入入一个，表表示少传传的参数数为iiid或numm_ii

15、id。这这所有的的错误信信息叠加加起来可可以知道道，这个个错误是是用户调调用taaobaao.iitemm.geet接口口时业务务处理发发现用户户没有传传入商品品id所导导致的。3) 平平台解析析错误平台解析错错误是指指topp返回的的错误码码小于1100的的情况。平平台解析析是非业业务性的的普适的的校验接接入层，主主要用于于对用户户的各种种权限、和和入参进进行最基基本的校校验。现现在的平平台错误误码主要要有：Isv可以以通过错错误码和和解释来来纠正问问题。如如：错误误码为33的响应应表示图图片上传传失败，错错误码为为26表示示用户没没有传入入sesssioon参数数，错误误码为227表示示用

16、户传传入的ssesssionn参数找找不到对对应的ssesssionn记录，等等等。4) 业业务处理理错误业务处理错错误是用用户通过过平台校校验进入入业务流流程出现现了错误误所发出出来的。这这一层的的错误码码根据调调用版本本不同分分为两种种。如果果版本是是1.00，那么么返回的的错误信信息格式式就是：“errror_rspp”:“codde”:XXXX,”msg”:”，里里面的ccodee是数字字形式的的标记着着一种错错误的编编码，mmsg是是字符串串形式，标标记在错错误的具具体信息息。如，获获取当商商品失败败的错误误信息就就是：errrorr_rssp:ccodee:5551,mssg:It

17、tem serrvicce uunavvaillablle:获获取单个个商品失失败。1.00的错误误码有以以下几种种：1.0的返返回的错错误coode就就是其中中的错误误码，错错误mssg就是是其中的的英文错错误描述述加上具具体的错错误信息息组成的的。如果版本是是2.00，那么么服务器器所返回回的错误误信息格格式就是是：“errror_ressponnse”:arggs:aarg:“key”:“ ”,”vallue”:” ”,“key”:“ ”,”vallue”:” ”,“key”:“ ”,”vallue”:” ”,”codde”:” ”,“msg”:” ”,”subb_coode”:” ”,

18、”subb_mssg”:” ”，里里面的ccodee是数字字形式的的标记着着一种业业务类型型的错误误编码，msg则是比较大范围内的表示错误类型的字符串。而sub_code是以字符串形式粗略表示错误的类型，sub_msg则是表示具体的错误原因。2.0的code包含以下几种分类：产品线错误码用户500类目510交易520退款521商品530商品扩展AAPI531邮费模板532产品540物流550店铺560评价570淘宝客580系统590备案591增量APII600比价610画报620江湖630分销640淘秀650收费660Misc(保证金金等杂项项apii)670由上图可知知，每一一大类的的api

19、在2.00中其实实是共享享一个ccodee的，它它能让用用户在复复杂组合合调用中中指导是是哪一类类的appi出现现了问题题，实现现初步的的定位。2.0的业业务错误误中，mmsg里里面最容容易出现现的内容容就是RRemoote serrvicce eerroor，这这表示用用户是在在通过了了平台校校验后进进行业务务流程的的时候出出现的错错误。其其他的错错误还有有Remmotee Seerviice Timmeouut：后后台处理理业务超超时等等等的错误误。这一一个错误误信息的的力度比比较粗，很很难单独独用她进进行错误误处理。2.0的业务处理错误信息主要要看sub_code和sub_msg这连个字

20、段。sub_code表示了服务费对业务错误的分类，sub_msg表示了是错误原因。Sub_ccodee根据业业务错误误类型主主要可以以分为如如下几类类子错误码错误归类user-nott-exxistt用户不存在在missiing-parrameeterr缺少参数invallid-parrameeterr参数错误parammeteers-missmattch参数不匹配配（主要要针对那那些需要要一一对对应的入入参）Invallid-perrmisssioon权限不足remotte-sservvicee-errrorr调用后端服服务错误误remotte-sservvicee-tiimeoout调用后

21、端服服务超时时remotte-cconnnecttionn-errrorr调用后端服服务连接接错误XXX-sservvicee-unnavaailaablee调用后端服服务失败败item-exttra-nott-exxistt商品扩展信信息不存存在tradee-noot-eexisst交易记录不不存在refunnd-nnot-exiist退款记录不不存在每一类的子子错误码码代表着着某一类类型的错错误，例例如usser-nott-exxistt表示用用户传入入的niick或者者用户绑绑定的ssesssionn所对应应的niick找找不到对对应的用用户记录录，Innvallid-perrmisss

22、ioon表示示用户由由于权限限问题不不能进行行某些操操作。ssub_codde给予予isvv或用户户以改进进错误的的方向，而而subb_mssg则告告诉用户户改进点点。例如如subb_coode为为invvaliid-pparaametter，subb_mssg为用用户传入入的iiid不能能超过440个，这这就表示示着，这这次错误误的原因因是用户户传入的的参数iiid由由于数量量超过440个而而产生了了错误。错误响应时时用户和和服务器器交互失失败的最最直接展展示，iisv在在调用ttop服服务时，如如果调用用失败，请请尽量保保留下错错误信息息（建议议尽量改改用2.0调用用，这个个版本的的错误信

23、信息比较较全面），以以便进行行后面的的错误追追查。三、 响应应格式错错误处理理响应格式错错误是指指用户调调用toop服务务时，传传入参数数设置了了forrmatt参数为为jsoon，但但是接受受到的却却为xmml的响响应格式式，或者者设置格格式为xxml接接收到的的却为jjsonn响应的的格式的的情况。一一般正常常情况下下这种情情况是不不会出现现的，但但是还是是会有一一些异常常的情况况会引起起这个问问题。这这种响应应格式错错误的问问题在iisv的的程序中中通常会会表现为为，响应应解析格格式错误误。例如如：用户户使用的的topp的javva SSDK客客户端调调用toop服务，设设置的fform

24、mat格格式为jjsonn却得到到了一个个xmll的响应应，这是是sdkk就会报报一个错错误说响响应开始始处缺少少一个“”符号。这这是因为为xmll响应是是以“”开始的的缘故。一般会发生生这种现现象的原原因有一一下三种种：用户户传入的的参数过过大导致致流解析析异常，用用户调用用太过频频繁道士士响应异异常，ttop服服务器故故障。为了定位到到问题出出在哪里里，以便便找到相相应的解解决方法法，用户户在遇到到响应格格式错误误的情况况时可以以参考以以下步骤骤进行调调试。1. 响响应格式式格式错错误，但但数据正正确用户第一步步应该分分析一下下相应的的内容里里面是不不是除了了格式错错误以外外，其他他的响应

25、应内容都都是正确确调用的的返回结结果。例如，有个个用户用用topp的sdkk，设置置forrmatt为jsoon，调调用top得到到了这样样一个返返回结果果：com.ttaobbao.apii.jsson.JSOONExxcepptioon:AJSOONObbjeccttexxtmusstbegginwitthatchaaraccterr111115520110-003-00116:04:1520110-003-00116:04:0520110-003-00116:03:5920110-003-00116:03:5320110-003-00107:30:52从这个异常常的开头头可以看看到，这这

26、是sddk的jsoon解析析抛了一一个异常常，说响响应内容容的内容容应该是是以“”开始的的。这说说名，iisv收收到的响响应格式式肯定出出了问题题。再看一下响响应的内内容相应结结果标签签之间包包含了ttotaalReesullts和和iteem列表表，这些些数据表表明，这这是调用用商品查查询接口口返回的的结果数数据：查查询到的的结果总总数是111155条，当当前页的的商品iiid和和最近修修改时间间也在其其中。这这些查询询结果数数据是正正常的，但但是返回回格式却却不是传传入的jjsonn而是变变成了xxml。这这位issv联系系了toop的技技术支持持，在建建议减缓缓调用频频率以后后，返回回的

27、数据据格式正正常了，这这样就临临时控制制了这种种情况的的发生。同同时技术术支持将将这些情情况反映映到了开开发，ttop这边后后续就会会找到问问题根源源，进一一步杜绝绝这种情情况的发发生。2. 响响应格式式错误，数数据也错错误如果用户第第一步分分析发现现，返回回的信息息并不是是调用成成功的信信息而是是某个平平台错误误，而且且用户本本身的参参数并不不会导致致这个错错误的产产生，此此时用户户就需要要查看自自己调用用接口的的参数了了。如果用户调调用的接接口需要要传入比比较大的的数据（如如：图片片、商品品的长篇篇描述等等等），那那么用户户应首先先尝试着着减小这这些入参参到合法法范围内内输入（传传入小图图

28、片或者者之传入入少量的的描述文文字等）。如如果用户户调用成成功，表表示错误误是因为为用户入入参太大大造成了了解析错错误引起起的，用用户应配配合自己己所在地地方的网网速，请请求大小小等等的的信息合合理设置置自己的的参数大大小和接接口调用用顺序。如果用户减减小参数数还是解解析失败败的话，用用户尝试试着不传传入图片片或只传传入几个个字节的的描述的的内容进进行接口口调用。在在传入描描述只有有很少的的字节的的情况下下：如果果不传图图片调用用成功了了，那么么应该是是topp的服务务器的问问题，请请将这个个情况反反馈给技技术支持持进行解解决；如如果图片片不传调调用仍然然失败了了，那么么应该是是用户的的调用参

29、参数或网网络有问问题，请请仔细对对照文档档说明对对参数进进行修改改或等待待网络状状态好一一点的时时候进行行调用。总的来说，如如果用户户发生了了响应格格式错误误的情况况，一般般分为三三种情况况：用户户本身传传入的fformmat就是错错误的，这这种情况况用户需需要查看看自己传传入的参参数是否否正确；用户通通信的网网络太差差，服务务端造成成请求解解析失败败而丢失失了foormaat信息息，这种种情况下下用户需需要调整整自己的的网络通通信情况况，等状状况恢复复再调用用；如果果是其他他由于图图片或调调用太频频繁而引引起的问问题，用用户需要要减小图图片或减减缓调用用来提高高成功率率，并且且将这些些情况通

30、通报给ttop技技术支持持的同学学。四、 平平台级错错误处理理在前文的错错误综述述中介绍绍过，ttop的的错误可可以分为为平台级级错误和和业务级级错误。所所谓平台台级错误误就是指指：错误误码小于于1000的调用用错误。这这种错误误一般是是由于用用户的请请求不符符合各种种的基本本校验而而引起的的。下面面将对于于各种平平台级错错误及相相应的解解决办法法陈列于于此。错误码错误解释解决办法3图片上传失失败将传入的图图片格式式改为正正确的格格式、适适当的大大小的图图片放进进消息体体里面传传输过来来。如果果传输仍仍然失败败需要减减小图片片大小或或者增加加网络带带宽进行行尝试4用户调用次次数超限限调整程序逻

31、逻辑合理理利用aapi，等等第二天天再调用用。或者者向技术术运维的的同学申申请增加加调用次次数5会话调用次次数超限限6合作伙伴调调用次数数超限7应用调用次次数超限限8应用调用频频率超限限Isv调节节apii调用频频率，不不能太过过频繁的的调用9HTTP方方法被禁禁止请用大写的的POSST或GETT，如果果有图片片等信息息传入则则一定要要用POOST才才可以10服务不可用用多数是由未未知异常常引起的的，用户户仔细检检查自己己传入的的参数是是否符合合文档中中描述的的样子11开发者权限限不足appKeey所对对应的应应用不具具备权限限调用当当前接口口。需要要联系运运营或技技术支持持的同学学开通调调用

32、该接接口的权权限。12用户权限不不足13合作伙伴权权限不足足15远程服务出出错Api调用用后端服服务出错错，issv首先先查看自自己的参参数是否否合法，如如果参数数没有问问题请过过一段时时间再尝尝试，如如果还不不行请联联系技术术支持21缺少方法名名参数传入的参数数加入mmethhod字字段22不存在的方方法名传入的meethood字段段必需是是你所调调用的aapi的的名称，并并且该aapi是是确实存存在的23非法数据格格式传入的foormaat必需需为jsson或或xmll中的一一种24缺少签名参参数传入的参数数中必需需包含ssignn字段25非法签名签名必需根根据正确确的算法法算出来来的。算

33、算法请见见：26缺少SesssioonKeey参数数传入的参数数中必需需包含ssesssionn字段27非法的SeessiionKKey参参数传入的seessiion必必需是用用户绑定定sesssioon拿到到的。如如果报ssesssionn不合法法可能是是用户没没有绑定定sesssioon或sesssioon过期期造成的的，用户户需要重重新绑定定一下然然后传入入新的ssesssionnKeyy。28缺少ApppKeyy参数传入的参数数必需包包含appp_kkey字字段29非法的ApppKeey参数数用户传入的的apppKeyy参数确确实是要要存在的的，如果果没有申申请apppKeey的同同学

34、请去去申请aappKKey，如如果是已已经有了了apppKeyy却调用用不同过过的，请请联系技技术支持持解决30缺少时间戳戳参数传入的参数数中必需需包含ttimeestaamp参参数31非法的时间间戳参数数用户传入的的时间戳戳不合法法。时间间戳，格格式为yyyyyy-mmm-ddd hhh:mmm:sss，例如如：20008-01-25 20:23:30。淘淘宝APPI服务务端允许许客户端端请求时时间误差差为100分钟。32缺少版本参参数传入的参数数中必需需包含vv字段33非法的版本本参数用户传入的的版本号号格式错错误，必必需为数数字格式式34不支持的版版本号用户传入的的版本号号没有被被提供。

35、现现在toop只支支持1.0或2.00两种版版本40缺少必选参参数用户传入的的参数中中漏掉了了必传的的参数。请请仔细对对照文档档检查41非法的参数数用户传入的的参数不不符合文文档中说说明的参参数格式式，请参参照文档档进行修修改42请求被禁止止请求 被禁禁止（目目前没有有在控制制）43参数错误参数解析发发生错误误或异常常。一般般是用户户传入参参数非法法引起的的。请仔仔细检查查入参格格式、范范围、是是否一一一对应等等等情况况。44Isp eerroor后台台接入服服务错误误这种后台服服务异常常引起的的错误，请请联系技技术支持持。基本上来说说，平台台错误是是一个通通用的、普普适的校校验。一一般针对对

36、用户的的权限、安安全、流流量和最最基本的的参数等等等进行行校验。用用户遇到到这些错错误的返返回一定定要第一一步检查查自己的的权限、频频率等情情况；然然后就需需要参照照文档检检验一下下自己的的传入的的参数是是否完整整且合法法；如果果这些都都无法解解决问题题，请联联系技术术支持的的同学进进行反馈馈，toop后台台会尽快快解决这这些问题题。五、 业业务级错错误处理理业务级错误误是指iisv请请求进入入topp业务处处理以后后爆出来来的业务务相关的的错误，通通常错误误码分部部在5000-110000之间。TTop的的业务错错误一般般可以分分为4个大类类：参数数错误、权权限控制制、用户户不存在在和服务务

37、错误。1. 参参数错误误参数错误指指toppapii根据业业务要求求对用户户传入的的参数进进行校验验组装的的时候产产生的错错误。1.0中的的参数错错误码有有： 5505,Miissiing Parrameeterrs;5066,PParaametterss errrorr;5507,Paarammeteers Forrmatt errrorr和XXXX,”XXXX noot eexisst”(这里XXXX表示示未知的的数字或或字符串串)等等。其其中：5505表表示缺少少传入某某些需要要传入的的参数(如：获获取skku列表表的时候候要求至至少传入入一个iiid，isvv却什么么都没有有传入);5

38、006表示示传入的的参数错错误（如如：传入入的iiid找到到对应的的商品已已删除、传传入的类类目不存存在等等等）；5507表表示用户户传入的的参数的的格式不不符合规规定（如如：需要要传入数数字的参参数用户户传入了了非数字字的字符符）；XXXX nott exxistt表示根根据用户户指定的的参数（如如：iiid、tidd等数据据）找不不到对应应的记录录，等等等。2.0中的的参数错错误的错错误码是是在调用用返回的的subb_coode子子错误码码里面得得到具体体体现的的。2.0的参参数错误误一般有有如下几几个错误误码：mmisssingg-paarammeteer，invvaliid-ppara

39、ametter，parrameeterrs-mmismmatcch，XXXX-noot-eexisst等等等。这几几种错误误分别表表示：mmisssingg-paarammeteer表示示缺少了了某些必必传参数数（如：获取单单个商品品是iiid和numm_iiid一个个都没传传入）；invvaliid-pparaametter表表示用户户传入的的参数错错误（如如：传入入的iiids个个数不符符合规定定，传入入的iiid对应应的商品品已删除除等等）；parrameeterrs-mmismmatcch表示示用户传传入的某某些有对对应关系系的参数数个数不不匹配了了（如：inpput_pidds和in

40、pput_strr长度不不匹配，或或者skku_ppropperttiess和skuu的其他他参数个个数不匹匹配）；XXXX-noot-eexisst表示示用户指指定的参参数找不不到对应应的记录录（即这这个参数数所对应应的记录录不存在在或已经经被删除除了）。不管是1.0还是是2.00的参数数错误，都都是由于于isvv传入的的参数有有问题而而引起的的。用户户在遇到到报参数数错误的的情况下下，需要要查看对对应的错错误消息息内容（1.0就是msg，2.0是sub_msg）中的说明来进行入参修改。建议将这部分内容展示给用户，可以让用直观的看到错误的原因，从而改进输入。2. 权权限控制制权限控制的的错误

41、是是指用户户使用了了自己不不享有的的服务所所造成的的错误。这这类型的的错误：1.00的错误误码为：5099,PPermmisssionn liimitted；2.00的子错错误码为为：innvallid-perrmisssioon。这这类型的的错误通通常都是是用户进进行的操操作触碰碰到了淘淘宝的业业务规则则，导致致了toop的业业务校验验不通过过。如：用户没没有登录录却要获获取某个个卖家仓仓库中的的商品，用用户不享享有多图图服务却却要上传传商品多多图或商商品属性性图片，成成人类目目直接上上传图片片，修改改自动发发货的商商品，不不是卖家家或买家家却要获获取交易易详细信信息的这些错错误并不不是用户

42、户传入的的参数找找不到相相应的数数据、或或者传入入的参数数是错误误的造成成的。相相反的，用用户传入入的参数数都符合合文档描描述，但但是用户户不具备备权限来来进行相相应的操操作。在这种情况况下，iisv有有几条路路可以选选择。第第一：对对于查询询类型的的权限控控制：如如果用户户是信息息的所有有者，那那么需要要让用户户进行登登录绑定定，这样样用户就就够进行行权限控控制的操操作了；如果用用户不是是信息的的合法查查看人，那那么issv要明明确的告告诉用户户这个操操作不可可以进行行，并且且不要进进行重试试操作了了。第二二：对于于增删改改类型的的操作的的权限控控制：如如果用户户是因为为没有享享有服务务（如

43、：没有享享有图片片空间的的服务）而而产生的的权限限限制，iisv需需要引导导用户去去进行服服务的开开通后再再来进行行操作，之之后再重重新调用用接口；如果是是因为用用户操作作了别人人的数据据而引起起的权限限控制，那那么issv要明明确的跟跟用户报报错，并并且不能能再进行行重试操操作。总之，当用用户遇到到报权限限控制的的错误时时，issv不能能直接进进行重试试。应该该将问题题直接告告诉用户户，并引引导用户户进行相相关的登登录、开开通服务务等操作作来调整整权限以以后，再再让用户户重试操操作。如如果用户户不愿意意进行调调整，iisv此此时应该该直接停停止该操操作，不不能默认认的进行行重试，因因为这种种

44、前提下下，重试试是完全全没有作作用的。3. 用用户不存存在用户不存在在是指ttop后后台根据据用户绑绑定的nnickk或者传传入的nnickk对用户户信息进进行查询询的时候候找不到到用户记记录所报报出的错错误。11.0的的错误码码：6001, Usser nott exxistt；2.00的子错错误码：useer-nnot-exiist。用户遇到这这种问题题首先请请确认调调用的这这个接口口自己有有没有传传入niick这个个参数。如如果niick是是根据用用户绑定定的seessiion取取得的，那那么用户户需要过过一会儿儿再重新新调用看看看。如如果隔一一段时间间还不行行，请联联系技术术支持解解决

45、。如果用户自自己通过过参数传传入了nnickk，那么么请用户户仔细检检查自己己传入的的nicck是否否正确。例例如：有有没有多多一个空空格或者者大小写写错误的的？该用用户是否否确实存存在的？等等。如如果问题题是因为为名称错错误或用用户确实实不存在在引起，用用户需要要更改输输入参数数后才能能再次调调用。如果用户名名称正确确，用户户也确实实存在，却却还是报报用户不不存在错错误，用用户需要要检查传传入的nnickk是否包包含难以以识别的的编码的的字体。如如果niick中中包含了了火星文文或者其其他编码码的字体体，请考考虑将nnickk转换成成utff8以后后重新尝尝试或者者放弃此此次操作作。如果上述

46、问问题都不不存在，请请联系技技术支持持的同学学进行查查看。整个查错过过程如下下所示：4. 服服务错误误服务错误主主要指用用户的请请求通过过了appi业务务的基本本校验，在在调用后后台服务务的时候候由于出出现了异异常或者者更进步步的业务务报错而而产生的的错误。这这一类错错误主要要分为33个大类类：服务务调用错错误、服服务调用用异常、远远程调用用错误、top解析错误。a) 服服务调用用错误服务调用错错误，是是指通过过topp校验进进入后端端调用服服务以后后，由于于不符合合进一步步的业务务逻辑校校验而出出现的错错误。如如：发布布商品的的属性不不符合商商品类目目的要求求，评价价的交易易已经过过期等等等

47、。这些些错误在在1.00的错误误返回错错误码为为：XXXX,”XXXX seerviice errror”，在2.0的返返回子错错误码为为：XXXX-sservvicee-errrorr。用户遇到这这种返回回表明ttop的的服务是是正常的的，是用用户的参参数不合合规定所所引起。请请根据返返回的具具体mssg和subb_mssg内容容定位问问题，然然后改正正入参后后再调用用。如果果确认参参数错误误却一直直通不过过调用，请请联系技技术支持持的同学学咨询情情况，切切勿盲目目重试。b) 服务务调用异异常服务调用异异常是指指服务调调用过程程中由于于后端服服务器没没有响应应或者产产生了异异常或者者topp

48、服务本本身产生生了未被被捕获的的异常而而产生的的错误。这这些错误误在1.0的错错误返回回错误码码为：XXXX,”XXXX seerviice unaavaiilabble”，在2.0的返返回子错错误码为为：XXXX-sservvicee-unnavaailaablee。这种错误有有可能是是后端服服务暂时时不可用用所引起起的，所所以用户户遇到这这种错误误时首先先应该查查看返回回的错误误信息里里面有没没有有效效的提示示信息，如如果有请请先按照照提示改改正问题题再调用用；如果果没有有有效的提提示信息息，请等等待一段段时间再再调用。如如果一直直都是这这个错误误，请联联系技术术支持查查看问题题所在。切切

49、忌立即即反复重重试。c) 远远程调用用错误远程调用错错误是指指topp在调用用后方服服务时发发生了调调用错误误或超时时的情况况。这类类错误可可能是由由于后端端服务过过于繁忙忙或者服服务失效效引起的的。这些些错误在在1.00的错误误返回错错误码为为：9000,Remmotee Coonneectiion Errror，9011,RRemoote Serrvicce TTimeeoutt，9022,RRemoote Serrvicce EErroor，在在2.00的返回回子错误误码为：remmotee-seerviice-errror，remmotee-seerviice-timmeouut，re

50、mmotee-coonneectiion-errror。用户遇到这这种情况况，首先先考虑的的是等待待一段时时间重试试看服务务是否恢恢复。如如果服务务已经恢恢复，则则这个只只是短时时间服务务过于拥拥挤造成成的；如如果多次次重试仍仍然是不不可用，那那么这个个可能是是后端服服务出了了问题，请请联系技技术支持持进行处处理。d) Toop解析析错误Top解析析错误目目前主要要针对的的是用户户调用ttop服服务时产产生的未未被捕获获的空指指针或者者参数转转换异常常所产生生的错误误。这些些错误是是由于用用户的请请求有错错误引发发了toop本身身的服务务流程的的潜在隐隐患所引引起的。1.0的错误返回错误码为：

51、510,Top parse error，在2.0的返回子错误码为：top-parse-error。用户遇到这这种问题题时，请请先仔细细检查自自己的参参数，根根据文档档说明修修改完善善以后再再尝试调调用，一一般正常常情况，只只要入参参合法是是能够成成功的。如如果确定定参数正正确的前前提下还还是调用用报这个个错误，请请联系技技术支持持的同学学反馈这这个问题题。六、 返返回参数数缺失处处理返回参数缺缺失是指指用户调调用appi返回回成功，但但是消息息体里面面的内容容和所请请求的内内容不一一致的情情况。这这种情况况细分可可以分为为三种情情况：整整个消息息体为空空、消息体体缺少文文档定义义的结构构返回、

52、返回的的结构体体中缺少少fieeldss指定的的某些字字段的返返回。1. 整整个消息息体为空空或缺少少文档中中说明的的结构体体返回。整个消息体体为空或或缺少文文档中说说明的结结构体是是指：返返回结果果是非失失败的情情况下，得得到的RRespponsse的boddy内容容和文档档定义不不一致（比比文档写写到要缺缺少某些些内容）的的情况。例例如：调调用新增增商品接接口，正正常的返返回结果果1.00是：rspp:ittemss:ccreaatedd:20009-111-117 116:330:550,iiid:cbbf8dd5d664b33fc880b225d221b11e1cc88ffd411。2

53、.00的返回回结果是是：iteem_aadd_ressponnse:iteem:iiid:6699ee0a775fccea339666d1dd57ffc82278cc6744b,crreatted:220099-100-222 155:088:422。根根据文档档的说明明：添加加商品成成功的返返回结构构体中包包含的数数据就是是这样。以此种返回回结果举举例，整整个消息息体为空空的情况况是指返返回的结结果为： 或iitemm_addd_rrespponsse: 。这这个消息息体里面面什么东东西都没没有，既既没有报报错的信信息，也也没有成成功响应应的数据据在里面面。如果果遇到此此种情况况，并且且这个情情况是在在某种条条件下课课