Changes between Initial Version and Version 1 of baby2.2_developers/interface


Ignore:
Timestamp:
03/03/2015 12:16:36 PM (11 years ago)
Author:
lianchijin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • baby2.2_developers/interface

    v1 v1  
     1[[TOC]] 
     2 
     3== 一.基本约定 == 
     4 
     5{{{ 
     6  1.开发机、测试机代理地址： 
     7  
     8   
     9  2.当接口处理正常时，HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。 
     10   
     11  3.当接口处理异常时，HTTP STATUS CODE 返回非200，并且给出具体的错误信息。 
     12      { 
     13         "desc":"给用户的提示放在这里" 
     14      } 
     15       
     16  4.接口默认的字符编码是UTF-8，接口需要实现对req-enc和resp-enc参数的支持。在JSP的最顶部，实现类似下面的代码： 
     17   
     18          String queryString = request.getQueryString(); 
     19          String requestEncoding = getParam(queryString,"req_enc"); 
     20          String responseEncoding = getParam(queryString,"resp_enc"); 
     21          if(isNotBlank(requestEncoding)){ 
     22              request.setCharacterEncoding(requestEncoding); 
     23          } 
     24          if(isNotBlank(responseEncoding)){ 
     25              response.setCharacterEncoding(responseEncoding); 
     26          } 
     27   
     28  5.所有有写操作的数据接口，必须用POST方式提交，在接口里需要判断提交方式，拒绝GET的调用请求。 
     29   
     30  6.接口中的JSON字符串，key都用双引号("")包裹，value是字符串类型时，也用双引号("")包裹；是数字类型时，不用引号 
     31   
     32  7.需要分页的接口，统一返回以下字段:  pageNo,pageSize,total 
     33}}} 
     34 
     35== 二.接口列表 ==