top错误断说明.doc

一、?????????? 错误处理流程概览 ? 从这个错误处理流程可知，在整个错误处理的过程中，一共可以分为3条主要的流程：请求解析异常流程处理，平台级错误处理和业务调用错误处理。当然，这一切处理的最初也是最重要的一步就是：将服务器响应内容保留下来。 二、?????????? 服务器响应内容透析 服务器响应内容，顾名思义就是isv调用top服务得到的响应的内容。这些内容能够最真实的反应出isv请求的问题和服务器当前的情况，也最能够帮助isv找到问题的所在。 服务器响应内容一般分为两种：一种是wiki文档中所编写的成功调用所返回的字段，另一种是调用失败的返回的错误相关信息。 ? 1.??????? 调用成功返回格式 调用成功的响应信息内容根据调用服务版本的不同分为了两种不同的格式。 1.0的服务返回信息的格式分为三层：最外一层是rsp:{ }标记，表示这是服务的响应内容；中间一层是返回结构体的标记，如：返回的是商品的结构体，中间这层就是items:[{ },{ }……]，表示结果是一个商品的列表，如果返回参数不是以结构体的形式，这一层就不存在；最内一层就是每个结构体具体的字段了。1.0这个版本所有返回结果，不论是单个的商品还是一个商品列表，他的第二层都是一个列表的结构，区别只是列表里有一个子结构体还是有多个子结构体而已。 相比之下，2.0的服务返回信息就相对的规范化了。2.0的响应内容主要也可以分为3层：最外一层是你调用服务的名称所对应的响应标记，如：获取单个商品（taobao.item.get）的响应最外层为item_get_response:{ }，表示这是获取单个商品的响应；中间一层是返回结构体的标记。如果结构体是单个，那么2.0返回的这一层里面就会是单个的结构，如：获取的单个商品的结构体就是item:{ }；反之，如果结构体是多个，那么列表也会明显的表示出来，如：搜索商品列表的结构体就会是”items”:{“item”:[{ },{ }……]}。最外层的items表示这是一个商品的列表，后面的item表示列表中的每一个子结构体都是属于商品item的，然后就跟着商品的数据；最内一层就商品的具体字段信息了。 ? 2.??????? 调用错误返回 当调用发生错误的时候，一般情况下可以分为几大类错误信息的返回：http连接错误、平台解析错误、业务处理错误。这三种类型的错误分别代表了：淘宝服务器、淘宝接入平台、top-api业务，几个层次上出现的问题。 1)??????? http连接错误 http连接错误是请求通信过程中出现的错误，这类型错误通常由http响应码标记出来。http响应码由三位十进制数字组成，它们出现在由HTTP服务器发送的响应的第一行。 响应码分五种类型，由它们的第一位数字表示： 1xx：信息，请求收到，继续处理 2xx：成功，行为被成功地接受、理解和采纳 3xx：重定向，为了完成请求，必须进一步执行的动作 4xx：客户端错误，请求包含语法错误或者请求无法实现 5xx：服务器错误，服务器不能实现一种明显无效的请求 Isv调用top服务最常收到就是200：http请求成功；404：未找到请求的服务；500内部服务器错误等等。如果用户收到的响应码是404，表示用户的网络有问题或者top被和谐了……如果用户收到的响应码是500，表示网络是ok的，是top的服务无法响应。 2)??????? 服务端错误总述 平台解析错误和业务处理错误都是http成功访问到top服务（http响应码返回为200）之后所产生的错信息，他们top处理isv请求过程中出现的问题。1.0和2.0的格式有所不同。 1.0的错误响应信息最外层为{“error_rsp”:{ }},表示这是调用错误所返回的信息。里面一层包含两个元素：”code”:” ”和 “msg”:” ”，前者表示错误码是多少，后者表示错误信息是什么。例如错误的调用1.0的taobao.item.get服务错误时返回的错误信息： {error_rsp:{code:40,msg:Missing required arguments:missing parameter iid/num_iid}}。 这个信息的开头为error_rsp，表示这是调用错误所返回的结果。里面包含的错误体的code为40，是平台型错误，表示错误是缺少了必传参数所引起的。然后msg内容为Missing required arguments:missing parameter iid/num_iid，表示缺少的必传参数是iid或者num_iid。Isv解析到这些信息后就需要根据错误信息改进自己传入的参数来使调用成功。 2.0的错误响应信息的最外层为{“error_response”:” ”}，表示这是调用服务失败