[[TOC]]

== 一.基本约定 ==

{{{
  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
}}}

== 二.接口列表 ==
=== 1.0 个人中心 ===
==== 1.1 问答回复数  ====
{{{
  备注：获取问答回复数
  接口开发：
  mrobot接口url： 
  后端url： 

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

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

}}}

==== 1.2 我的问答数量 ====
{{{
  备注:获取我的问答数量
  接口开发：卢海潮
  mrobot请求URL：
  后端请求URL：http://kuaiwen.pcbaby.com.cn/intf/app/my_questions_nums.jsp
  接口说明：http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/9
  HTTP请求方式：get
  是否需要登录：是
  返回格式：JSON
  缓存方式：无
  缓存时间：无
  请求参数：
  设置header  Cookie = "common_session_id=xxxx";
  v = 2.2  //版本号

  返回参数
  {
   solvedCount:已解决数量
   unsolvedCount:未解决数量
  }
}}}

=== 2.0 崔玉涛视频 ===
==== 2.1 崔玉涛专栏首页 ====
{{{
  备注：崔玉涛专栏首页接口（v2.2开始崔玉涛视频列表增加播放次数字段）
  mrobot接口url：http://mrobot.pcbaby.com.cn/v2/qzbd/cytHome
  后端接口url:
      http://www.pcbaby.com.cn/app/qzbd2/cyt/
      http://ivy.pconline.com.cn/adpuba/show?id=pc.khd.zx.btxfldxj.&media=js
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  是否有缓存：有
  缓存时间：15分钟
  请求参数：
  v = 2.2  //版本号

  返回参数:
{
   "status": 0, //状态码  0正常返回   非0请求错误
   "desc": "",  //提示信息    status＝0提示信息为空；status非0，给出对应的出错提示信息
   "authorInformation" : //专家信息
     {
        "face" : ""   //专家头像
        "name" : ""   // 专家姓名
        "title" : ""  //职称
 	"position" : "" //职务
   	"introduction" : ""  //专家介绍
    },
   "ads": //广告
       [
         {
            "image":  ""    //广告图片
 	    "toUri"  :  ""  //跳转uri
         }
       ],
   "hot": //育儿热点
     { 
        "title":"育儿热点",
        "section":[
           { 
              "categoryId":  //分类id
              "title": //分类标题 
              "image": //图片
           }
          ...
 	  ]
     },
   "video": //在线视频
    { 
        "title":"在线视频",
        "section":[
           {
              "articleId": "1987318",
              "date": "2014-12-11",
              "image": "http://img0.pcbaby.com.cn/pcbaby/zhuanjia/jtye/shipin/1412/yekebuting.jpg",
              "title": "亲子课堂：孩子夜咳不停怎么回事？",
              "count":"10"   //视频播放次数
             }
          ...
 	  ]
   },
   "question": //问答专栏
    { 
        "title":"问答专栏",
        "section":[
           {
               "articleId": "2042246",
               "num": "3",//专栏期数id
               "date": "2015-01-06",
               "expertId": "29003920",
               "image": "http://www1.pcbaby.com.cn/03daodu.jpg",
               "title": "孩子经常发烧怎么办？"
           }
           ...
 	  ]
    },
    "article": //育儿文章
    { 
        "title":"育儿文章",
        "section":[
            {
               "articleId": "2048505",
               "date": "2015-01-06",
               "image": "http://img0.pcbaby.com.cn/pcbaby/1501/06/g_2048505_1420534505891.jpg",
               "preview": "育儿路上烦恼多，怎么才能护理好孩子的日常起居？怎么可以培养孩子的各项能力？遇到了这些问题就赶紧来提问吧！除了能得到专家的答疑，还有机会赢得崔玉涛医生的育儿书籍一本哦。",
               "title": "【提问有礼】赢崔玉涛育儿书"
             }
             ...
 	  ]
   }
}
}}}

==== 2.2视频列表 ====
{{{
  备注：视频列表（接口已完成，使用请连开发机代理）
  mrobot接口url：http://mrobot.pcbaby.com.cn/v2/qzbd/cytList?type=video&pageNo=1&pageSize=20
  后端接口url:http://www.pcbaby.com.cn/app/qzbd2/cyt/video/
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  是否有缓存：有
  缓存时间：15分钟
  请求参数：
    pageNo    //第几页
    pageSize  //每页显示多少条
    type      //类型，此次type=video
    v = 2.2  //版本号

  返回参数:
{
    "data": [
        {
            "articleId": "1987318",
            "date": "2014-12-11",
            "image": "http://img0.pcbaby.com.cn/pcbaby/zhuanjia/jtye/shipin/1412/yekebuting.jpg",
            "title": "亲子课堂：孩子夜咳不停怎么回事？",
            "count":"10"   //视频播放次数
        }
    ],
    "pageCount": 1,
    "pageNo": 1,
    "pageSize": 20,
    "total": 1
}
}}}

==== 2.3统计视频播放次数 ====
{{{
  备注：统计单个视频播放次数
  mrobot接口url：
  后端接口url:http://v.pcbaby.com.cn/__counter.jsp?video=1162
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  是否有缓存：有
  缓存时间：
  请求参数：
    video    //视频id
    v = 2.2  //版本号

  返回参数:（附：原始接口返回200状态码表示成功）
{
    "ret": 0, //返回状态，0=成功，非0 =失败
    "desc": "提示信息"  //错误提示信息
}
}}}

=== 3.0 交流圈 ===
==== 3.1 私密圈 ====
===== 3.1.1 私语、话题列表 =====
{{{
  备注:获取私密圈私语、话题列表
  接口开发：丁健勇
  mrobot接口URL：
  后端接口URL：
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  缓存方式：无
  缓存时间：
  请求参数：
  type:1私语（默认），2话题
  pageNo:1 //页码
  pageSize:20 //每页条数
  v = 2.2  //版本号
  
  返回参数,成功：
{
  pageNo: 1,    //页码
  pageSize: 20, //每页条数
  total: 15163, //总数量
  topics: [
    { 
      topicId: 2156386,          //帖子ID
      title: "最难忘前任的那点",    //标题
      message: "最难忘前任的那点", //帖子内容（当recommend＝1且recommendType＝3时，这里为“引导话题贴内容”）
      createAt: "2015-01-12 14:34:15",    //发帖时间
      viewCount: 2,  //帖子浏览数 
      replyCount: 0,  //帖子回复数
      recommend: 0, //是否推广位数据：0＝否；1=是
      recommendType: 1, //私语列表推广类型：1＝话题贴通显推广；2=私密贴推广；3= 话题引导贴推广（当取话题列表数据时，该字段忽略）  
      tagName: "杜蕾斯专场",  //专场标签（string类型，字段为空时表示无标签）
      guestName: "毒舌辣妈", //特邀嘉宾标签 (string类型，字段为空时表示无标签）
    }
  ]
}
}}}

===== 3.1.2 闺蜜列表 =====
{{{
  备注:获取私密圈－闺蜜列表
  接口开发：丁健勇
  mrobot接口URL：
  后端接口URL：
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  缓存方式：无
  缓存时间：
  请求参数：
  pageNo:1 //页码
  pageSize:20 //每页条数
  v = 2.2  //版本号
  
  返回参数,成功：
 {
  pageNo: 1,    //页码
  pageSize: 20, //每页条数
  total: 15163, //总数量
  topics: [
    {  
      replyAuthorFace:"http://img.pcbaby.com.cn/images/upload/upc/tx/pcbabyfk/1412/18/c0/793654_1418869304618_180x180.jpg", //显示闺蜜达人在个人中心的头像(180x180)
      replyAuthorName: "毒舌辣妈", //显示闺蜜达人在个人中心的昵称
      replyContent: "我觉得大部分女人都会比较希望老公终身不娶的女儿！", //回帖内容
      replyTime: 1420790175000, //回帖时间
      source: 0, //列表来源  0=私语，1=话题
      message: "常常会想一个问题就是如果我不幸离世了，我的老公...", //主贴内容
      topicId: 2151480, //帖子ID
      viewsNum: 33, //帖子查看数量
      commentNum: 6, //帖子评论数
    }
  ]
}
}}}

==== 3.2 生活圈 ====
===== 3.2.1 潮妈列表 =====
{{{
  备注：生活圈潮妈列表,时间倒序
         （后端接口已有，mrobot做中转，参考接口：http://trac.pc.com.cn/iphone/wiki/baby/interface#a4.1生活圈精华帖子列表）
  接口开发：丁健勇
  mrobot接口URL：
  后端接口URL：http://bbs.pcbaby.com.cn/intf/forum/getPicks.do
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  缓存方式：有
  缓存时间：

  请求参数：
  forums= 1917,2130,1828,1799,1820,2140,1771,1776,2200;需要查询的版块ID，多个版块ID用半角逗号分隔。查找的信息也会包含其子版块 
     //（说明：潮妈forums参数值固定为1917,2130,1828,1799,1820,2140,1771,1776,2200。其它某个论坛的ID根据列表得到的forums ID传入即可）
  noForums= 1929;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块（说明：潮妈才需要用到的参数，固定为1929）
  pickType= pick3;精华类型//剩余type指的是什么呢？（说明：潮妈，pickType为pick3，其它论坛pickType为all）
  maxLength:帖子内容需要截取的长度，默认240个字节
  showImage=true;显示图片
  ie=utf-8;输出内容的编码格式
  cacheTime=1200;缓存时间，单位为秒
  pageNo:1 //页码
  pageSize:10 //每页条数
  v = 2.2  //版本号

  返回参数：
{
  desc: "查询成功", //状态描述
  pageNo: 1, //页码
  pageSize: 20, //每页条数
  status: 0, //状态码
  topics: [
    {
      createAt: "2015-01-11 19:30:35", //帖子的创建时间
      images: [ //帖子图片组成的数组
        "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c1/1752585_1420975033163_1024x1024.jpg",
        "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c1/1752586_1420975112551_1024x1024.jpg",
        "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c1/1752588_1420975163834_1024x1024.jpg"
      ],
      title: "超可爱萌妹子融化人心", //帖子标题
      message: " 《雯雯 萌萌哒》超级可爱的萌妹子，完全可以萌化到心底里...", //帖子内容
      topicId: 2155848, //帖子id
      userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/12/65/76/7/1265767_70x70", //用户头像
      userId: 1265767, //用户ID
      userName: "啃蘋果的壞蛋", //用户昵称
      views: 22, //帖子浏览数
      replyCount: 2, //帖子回复数
    }
  ],
  total: 515 //总帖子数
}
}}}