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


Ignore:
Timestamp:
05/23/2015 04:38:29 PM (11 years ago)
Author:
lianchijin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • baby2.3_developers/interface

    v1 v1  
     1[[TOC]] 
     2 
     3== 一.基本约定 == 
     4 
     5{{{ 
     6  1.开发机、测试机代理地址： 
     7  mrobot开发机代理：192.168.10.199  端口：1080 
     8  mrobot测试机代理：192.168.10.198  端口：1080 
     9   
     10  2.当接口处理正常时，HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。 
     11   
     12  3.当接口处理异常时，HTTP STATUS CODE 返回非200，并且给出具体的错误信息。 
     13      { 
     14         "desc":"给用户的提示放在这里" 
     15      } 
     16       
     17  4.接口默认的字符编码是UTF-8，接口需要实现对req-enc和resp-enc参数的支持。 
     18   
     19  5.所有有写操作的数据接口，必须用POST方式提交，在接口里需要判断提交方式，拒绝GET的调用请求。 
     20   
     21  6.接口中的JSON字符串，key都用双引号("")包裹，value是字符串类型时，也用双引号("")包裹；是数字类型时，不用引号 
     22   
     23  7.需要分页的接口，统一返回以下字段:  pageNo,pageSize,total 
     24   
     25  8.涉及接口都增加请求参数：v = 230  //版本号(数字) 
     26 
     27  
     28}}} 
     29 
     30== 二.接口列表 == 
     31=== 1.0 个人中心 === 
     32==== 1.1 问答回复数  ==== 
     33{{{ 
     34  备注：获取新的未读问答回复数（接口已完成，使用请连开发机代理） 
     35  （参考接口：http://trac.pc.com.cn/kuaiwen_baby/ticket/54） 
     36  接口开发：吴全贵，陈子洋 
     37  mrobot接口url：http://mrobot.pcbaby.com.cn/s/qzbd/kuaiwen/myQuestionReplyNums.xsp（已放在192.168.75.40开发机） 
     38  后端url：http://kuaiwen.pcbaby.com.cn/intf/app/my_question_reply_nums.jsp（已在线上） 
     39 
     40  HTTP请求方式：get 
     41  是否需要登录：否 
     42  返回格式：JSON 
     43  是否有缓存：无 
     44  缓存时间： 
     45  请求参数： 
     46  设置header  Cookie = "common_session_id=xxxx"; 
     47  v = 220  //版本号 
     48 
     49  返回参数 
     50{ 
     51    "ret": 0, //返回状态，0=成功，非0=失败 
     52    "questionsCount": 10,  //问答回复数 
     53    "desc": "提示信息" //错误提示信息 
     54} 
     55 
     56}}} 
     57