wiki:baby2.3_developers/interface

Version 1 (modified by lianchijin, 11 years ago) (diff)

--

一.基本约定

  1.开发机、测试机代理地址:
  mrobot开发机代理:192.168.10.199  端口:1080
  mrobot测试机代理:192.168.10.198  端口:1080
  
  2.当接口处理正常时,HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。
  
  3.当接口处理异常时,HTTP STATUS CODE 返回非200,并且给出具体的错误信息。
      {
         "desc":"给用户的提示放在这里"
      }
      
  4.接口默认的字符编码是UTF-8,接口需要实现对req-enc和resp-enc参数的支持。
  
  5.所有有写操作的数据接口,必须用POST方式提交,在接口里需要判断提交方式,拒绝GET的调用请求。
  
  6.接口中的JSON字符串,key都用双引号("")包裹,value是字符串类型时,也用双引号("")包裹;是数字类型时,不用引号
  
  7.需要分页的接口,统一返回以下字段:  pageNo,pageSize,total
  
  8.涉及接口都增加请求参数:v = 230  //版本号(数字)

 

二.接口列表

1.0 个人中心

1.1 问答回复数

  备注:获取新的未读问答回复数(接口已完成,使用请连开发机代理)
  (参考接口:http://trac.pc.com.cn/kuaiwen_baby/ticket/54)
  接口开发:吴全贵,陈子洋
  mrobot接口url:http://mrobot.pcbaby.com.cn/s/qzbd/kuaiwen/myQuestionReplyNums.xsp(已放在192.168.75.40开发机)
  后端url:http://kuaiwen.pcbaby.com.cn/intf/app/my_question_reply_nums.jsp(已在线上)

  HTTP请求方式:get
  是否需要登录:否
  返回格式:JSON
  是否有缓存:无
  缓存时间:
  请求参数:
  设置header  Cookie = "common_session_id=xxxx";
  v = 220  //版本号

  返回参数
{
    "ret": 0, //返回状态,0=成功,非0=失败
    "questionsCount": 10,  //问答回复数
    "desc": "提示信息" //错误提示信息
}

Attachments