[[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
  
  8.涉及接口都增加请求参数：v = 230  //版本号(数字)

 
}}}

== 二.接口列表 ==
=== 1.0怀孕首页 ===
{{{
  备注：怀孕首页接口（只针对怀孕首页的数据，备孕、育儿首页接口参照v2.2.0不变）
  说明：v2.2.0首页接口 http://trac.pc.com.cn/iphone/wiki/baby2.2_developers/interface#a6.0首页
  
  1)mrobot接口url：
     备孕首页：http://mrobot.pcbaby.com.cn/v2/qzbd/home/1?v=230
     怀孕首页：http://mrobot.pcbaby.com.cn/v2/qzbd/home/2?v=230&lemmaId=281
     育儿首页：http://mrobot.pcbaby.com.cn/v2/qzbd/home/3?v=230
  2）后端接口：
     怀孕首页：http://www.pcbaby.com.cn/app/qzbd2/hysy/
     每日知识接口：http://baike.pcbaby.com.cn/intf/app/2.0/timeline_content_list_301.jsp?lemmaId=31

  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  是否有缓存：有
  缓存时间：
  请求参数：
     {id}        //栏目id
     v = 230   //版本号
     lemmaId=281  //时间轴id
     agent        //客户端标识，2为IOS，3为Android
  
  返回参数:
  {
   focus:[  //焦点图数据
     {
       id:  //  id："articleId=234&expertId=112&num=111"（  推“专栏详情”的推广时id为文章id&专家id&专栏期数id）
       image:
       title:
       type:论坛（1列表、2终端）；亲子学院（3列表、4终端）；活动（5列表、6终端）；工具（7终端）；食谱（8终端）；资讯（9终端）；
            问答（10终端）；百科（11终端）；崔玉涛视频（12视频文章终端）；专栏详情（13）
       url:(活动、工具终端打开需要url，不需要时为空字符串)
     }
   ],
  "timeline": { //每日知识内容
      "index":  //发育指标
          {
              "description": "胎长约38.5cm，胎重约1600g。这时候他已有4个佛手柑那么重了。现在，你的体重可能已经增加了8.5kg。小腹更加突出了。",
              "id": 245,
              "image": "http://img.pcbaby.com.cn/images/upload/upc/tx/baby_baike/1408/01/c0/36948482_1406875934412.jpg",
              "title": "胎儿发育和妈妈变化",
              "type": "11"
          },
      "point": [ //知识点概括
         {
              "description": "进入孕后期，你可能会感到尿频和总有尿不完的感觉。这个阶段有将近80%的孕妇为尿频困扰，很多孕妈妈在夜间需要更频繁地起床跑厕所。",
              "id": 511,
              "title": "孕妇尿频",
              "type": "11"
         },
         {
              "description": "孕期气短通常没有什么大碍，也很正常。在日常生活中把节奏放慢一些，活动或运动的时候，不要太勉强自己。",
              "id": 633,
              "title": "孕妇气短",
              "type": "11"
         }
       ],
   }
   recommendChannel:[ //热门栏目
    {
      title:  //根据栏目名称跳转至对应模块
      type:  //热门栏目类型（type＝5表示家庭育儿）
             //type=1 阅读，type=2 百科，type=3 交流圈，type=4 每日知识，type=5 家庭育儿，type=6 问答，type=7 活动，type=8 工具，type=9 每日食谱    
    }
   ],
  recommendContent:  //内容维护区（这里列出了所有内容类型的数据，接口实际只会返回其中的一种类型）
  [ 
    {
      type:1 //类型：图集；内容类型（type=1 图集，type=2 视频，type=3 专家视点&问答专栏，type=4 精彩活动，type=5 资讯文章，type=6 百科文章，type=7 生活圈帖子，type=8 私密圈帖子，type=9 html页）
      image: //图片url
      title: //标题
      imageCount:13 //图集总数
      albumsId:  //图集id
    },
    {
      type:2 //类型：视频
      image: //图片url
      title: //标题
      preview:"孩子经常发烧" //简介 
      articleId: "2042246", //文章id
      videoId: "2006"， //视频id
    },
    {
      type:3 //类型：专家视点&问答专栏
      image: //图片url
      title: //标题
      url:  //专家视点页面url
      expertName: //专家名
      position:"副主任医师" //职位
      department: "儿科"， //科室
      id:  //视点文章id
    },
    {
      type:4 //类型：精彩活动
      image: "http://www1.pcbaby.com.cn/03daodu.jpg",
      url：// 活动页面url
    },
    {
      type:5 //类型：资讯文章
      image: "http://www1.pcbaby.com.cn/03daodu.jpg",
      title: "孩子经常发烧怎么办？",
      preview:"孩子经常发烧" //简介
      articleId: "2042246" //文章id 
    },
    {
      type:6 //类型：百科文章
      image: "http://www1.pcbaby.com.cn/03daodu.jpg",
      title: "孩子经常发烧怎么办？",
      preview:"孩子经常发烧" //简介
      url: "http://baike.pcbaby.com.cn/app/zsd/1190.html" //百科文章url
    },
    {
      type:7 //类型：生活圈帖子
      image: "http://www1.pcbaby.com.cn/03daodu.jpg",
      title: "孩子经常发烧怎么办？",
      preview:"孩子经常发烧" //简介
      topicId: 2155710, //帖子ID
    }, 
    {
      type:8 //类型：私密圈帖子
      image: "http://www1.pcbaby.com.cn/03daodu.jpg",//私密贴icon
      title: "孩子经常发烧怎么办？",
      preview:"孩子经常发烧" //简介
      topicId: 2155710, //帖子ID
    },         
    {
      type:9 //类型：html页
      image: "http://www1.pcbaby.com.cn/03daodu.jpg",
      title: "孩子经常发烧怎么办？",
      preview:"孩子经常发烧" //简介
      url: "http://baike.pcbaby.com.cn/app/zsd/1190.html" //html页面url
    },           
  }
  ],
  topics:[ //精彩话题（生活圈与私密圈帖子一共出5条数据，两者出现的顺序与数目不固定，但总数目不变：5条）
    { //生活圈帖子
      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, //帖子回复数
    }
    ...
    {  //私密圈帖子
      topicId: 2156386,          //帖子ID
      title: "最难忘前任的那点",    //标题
      message: "最难忘前任的那点", //帖子内容
      createAt: "2015-01-12 14:34:15",    //发帖时间
      viewCount: 2,  //帖子浏览数 
      replyCount: 0,  //帖子回复数
    }
    ...
  ]
  topFocus: [ //焦点图广告
    {
      cc-uri: "",
      image: "http://www1.pcbaby.com.cn/appguanggao/1.jpg?IVY_LEVEL_1?481456_307375",
      seq: 1,
      title: "广告",
      to-uri: "http://ivy.pconline.com.cn/adpuba/click?adid=307375&id=test.gjz.zicong.",
      updateAt: 1408678837215,
      vc-uri: "none"
    }
   ]
  }
}}}

=== 2.0怀孕每日知识 ===
{{{
  备注：怀孕每日知识首页
  接口开发:
  mrobot接口：
  后端URL：
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  缓存方式：无
  缓存时间：无
  请求参数：
  lemmaId：时间轴id
  v = 230   //版本号

  返回参数:
 {
   ad:[  // 广告数据
     {
        "content": "",//广告内容
        "url": "" //广告跳转url
     }
   ], 
   cookbook:[  //今日食谱数据
        {
          "day": "第1天", //当前天数
          "detail": [
            {
		"des": "薏米银耳羹", //食谱详情
		"id": 21739,  //食谱id
		"image": "http://xxx", //食谱图片
		"title": "银耳薏米汤" //食谱标题
           }, 
           {
		"des": "宫寒会",
		"id": 24339,
		"image": "http://xxx",
		"title": "饮食驱宫寒有助女性受孕"
	  }
         ]
       }
   ],
   "timeline": //每日知识内容
   {
      "index":  //发育指标
          {
              "description": "胎长约38.5cm，胎重约1600g。这时候他已有4个佛手柑那么重了。现在，你的体重可能已经增加了8.5kg。小腹更加突出了。",
              "id": 245,
              "image": "http://img.pcbaby.com.cn/images/upload/upc/tx/baby_baike/1408/01/c0/36948482_1406875934412.jpg",
              "title": "胎儿发育和妈妈变化",
              "type": "11"
          },
      "point": [ //每日知识
         {
              "description": "进入孕后期，你可能会感到尿频和总有尿不完的感觉。这个阶段有将近80%的孕妇为尿频困扰，很多孕妈妈在夜间需要更频繁地起床跑厕所。",
              "id": 511,
              "title": "孕妇尿频",
              "type": "11"
         },
         {
              "description": "孕期气短通常没有什么大碍，也很正常。在日常生活中把节奏放慢一些，活动或运动的时候，不要太勉强自己。",
              "id": 633,
              "title": "孕妇气短",
              "type": "11"
         }
       ]
    }
 }
}}}

==== 2.1怀孕本周知识 ====
{{{
  备注：怀孕本周知识
  接口开发:
  mrobot接口：
  后端URL：
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  缓存方式：无
  缓存时间：无
  请求参数：
  lemmaId："13923;13924;13925;13926;13927;13928;13929"   //时间轴id（字符串，传该周对应的所有时间轴id，分号隔开）
  v = 230   //版本号

  返回参数:
 {
   "timeline": [ //本周知识内容
     {
      "index":  //发育指标
          {
              "description": "胎长约38.5cm，胎重约1600g。这时候他已有4个佛手柑那么重了。现在，你的体重可能已经增加了8.5kg。小腹更加突出了。",
              "id": 245,
              "image": "http://img.pcbaby.com.cn/images/upload/upc/tx/baby_baike/1408/01/c0/36948482_1406875934412.jpg",
              "title": "胎儿发育和妈妈变化",
              "type": "11"
          },
      "point": [ //每日知识
         {
              "description": "进入孕后期，你可能会感到尿频和总有尿不完的感觉。这个阶段有将近80%的孕妇为尿频困扰，很多孕妈妈在夜间需要更频繁地起床跑厕所。",
              "id": 511,
              "title": "孕妇尿频",
              "type": "11"
         },
         {
              "description": "孕期气短通常没有什么大碍，也很正常。在日常生活中把节奏放慢一些，活动或运动的时候，不要太勉强自己。",
              "id": 633,
              "title": "孕妇气短",
              "type": "11"
         }
       ],
     "lemmaId"：281 //时间轴id
     "timeNode":"11周整"
    }
    ...
  ]
 }
}}}

=== 3.0专家视点 ===
{{{
  备注：专家视点
  接口开发:
  mrobot接口：
  后端URL：
  HTTP请求方式：get
  是否需要登录：否
  返回格式：html页面
  缓存方式：无
  缓存时间：无
  请求参数：
  v = 230   //版本号
  id:  //视点文章id

  返回参数:
   html页面
}}}

=== 4.0孕期体重记录 ===
{{{
  备注：孕期体重记录
  说明：根据返回参数的BMIType值选择对应的计算公式 ，参照附件《孕妇体重的算法(2)》

  接口开发:陈子洋
  mrobot接口：http://mdata.pconline.com.cn/pcbaby/user/weightHeight.jsp
  （开发环境http://dev40.pconline.com.cn:81/）
  HTTP请求方式：get
  是否需要登录：是
  返回格式：json
  缓存方式：无
  缓存时间：无
  请求参数：
  v = 230   //版本号
  设置header  Cookie = "common_session_id=xxxx"; //登陆用户id

  返回参数:
  {
	"code":0, //状态码,0=成功获取数据，-4=用户未登录，-3=程序异常
        "msg":"数据获取成功" //提示信息
        "BMIType":4 //BMI指数类型（4孕前正常，5孕前偏瘦，6孕前偏重)
        "preWeight"：//孕前体重(float型)
        "height":  //用户身高(float型)
        "dueDate"：预产期
        "data": [
            {
           	"lemmaId": 281, //时间节点id
		"weight": 58.0 // 体重
	    },
            {
		"lemmaId": 282, //时间节点id
		"weight": 59.0 // 体重
       	    }
            ...
         ]
 }
}}}

==== 4.1初次记录体重身高预产期 ====
{{{
  备注：初次记录体重身高预产期
  说明：初次使用，输入孕前体重与身高，app端计算BMIType值，并将BMIType值、孕前体重preWeight、当前体重weight、用户身高height、时间节点lemmaId，预产期dueDate

  接口开发:陈子洋
  mrobot接口：http://mdata.pconline.com.cn/pcbaby/user/weightHeight.jsp
  HTTP请求方式：post
  是否需要登录：是
  返回格式：json
  缓存方式：无
  缓存时间：无

  请求参数：
  act = once   //操作参数，必须
  v = 230   //版本号
  设置header  Cookie = "common_session_id=xxxx"; //登陆用户id
  BMIType ＝ 4 //BMI指数类型（4孕前正常，5孕前偏瘦，6孕前偏重），必须
               //说明：第一次操作时，app通过计算孕前体重与身高得出BMI值，并得出BMIType指数类型（BMIType＝5:偏轻BMI＜18.5，BMIType＝4:正常18.5≤BMI≤24.9，BMIType＝6:偏重25≤BMI≤29.9）
  preWeight：孕前体重(float型)，必须
  weight：当前体重(float型)，必须
  height:  用户身高(float型)，必须
  lemmaId：时间节点id（将所选时间转换为对应时间节点），必须
  dueDate："20150604"  //预产期（字符串，格式为“20150604”），必须

  返回参数:
  {
	"code":0, //状态码,0=数据保存成功,-4=用户未登录，-3=程序异常,-2=请求参数错误,-1=无效的act操作参数     
        "msg":"数据保存成功" //提示信息
 }
}}}

==== 4.2记录当日体重 ====
{{{
  备注：记录体重身高
  说明：非初次使用只需传当前体重weight、时间节点lemmaId

  接口开发:陈子洋
  mrobot接口：http://mdata.pconline.com.cn/pcbaby/user/weightHeight.jsp
  HTTP请求方式：post
  是否需要登录：是
  返回格式：json
  缓存方式：无
  缓存时间：无

  请求参数：
  act = add  //操作参数，必须
  v = 230   //版本号
  设置header  Cookie = "common_session_id=xxxx"; //登陆用户id
  
  weight：当前体重(float型)，必须
  lemmaId：时间节点id（将所选时间转换为对应时间节点），必须

  返回参数:
  {
	"code":0, //状态码,0=数据保存成功,-4=用户未登录，-3=程序异常,-2=请求参数错误,-1=无效的act操作参数     
        "msg":"数据保存成功" //提示信息
 }
}}}

==== 4.3健康建议 ====
{{{
  备注：健康建议
  接口开发:
  mrobot接口：
  后端URL：
  HTTP请求方式：get
  是否需要登录：否
  返回格式：html页面
  缓存方式：无
  缓存时间：无
  请求参数：
  v = 230   //版本号
  type = 1 //当前体重类型（1正常，2偏瘦，3偏重）
  BMIType ＝ 4 //孕前体重（4孕前正常，5孕前偏瘦，6孕前偏重）
  height:  //用户身高
  weight: //体重记录表格中最后一次记录的体重(float型)

  返回参数:
   html页面
}}}

=== 5.0分享 ===
{{{
  备注：涉及分享的webView页面
  说明：接口涉及要点（以下都是指在页面注释json内的改动）
      1、新增参数showShare控制分享按钮是否出现
      2、返回自定义分享文案（包括标题、内容、分享url、分享图片）
      3、增加协议pcbabybrowser://changePreView，通知客户端刷新自定义分享内容
      4、增加协议pcbabybrowser://activity-share，网页可调用客户端分享控件
      5、分享到新浪微博、腾讯微博时，“@”的部分可以修改（新增字段name）

  接口:
  1、问答终端 http://mrobot.pcbaby.com.cn/v2/qzbd/askDetail?qId=636472
       分享url：http://m.pcbaby.com.cn/kuaiwen/question/%@.html

  2、百科文章 http://baike.pcbaby.com.cn/app/zsd/4495.html
       分享url：http://m.pcbaby.com.cn/baike/qzbd/%@.html

  3、帖子终端 http://mrobot.pcbaby.com.cn/v2/bbs/topics/2867187?pageNo=1&size=17&picRule=2&v=230&newQuote=true
      分享url：http://m.pcbaby.com.cn/bbs/topic-%@.html

  4、资讯文章 http://mrobot.pcbaby.com.cn/v3/cms/articles/2307504?pageNo=1&size=17&picRule=2
      分享url：取html页面 中的wap_url

  5、活动 http://m.pcbaby.com.cn/bbs/topic-2831226.html?fromPcbabyApp
       分享url：取html页面 中的wap_url

  HTTP请求方式：get
  是否需要登录：否
  返回格式：html页面
  缓存方式：无
  缓存时间：无
  请求参数：

  返回参数:
   html页面

  调用客户端分享控件跳转协议：pcbabybrowser://activity-share
  通知客户端刷新自定义分享内容跳转协议：pcbabybrowser://changePreView
  用于分享的参数：
  /*@_HTML_META_START_
  {
	"firstPic":"http://img0.pcbaby.com.cn/pcbaby/app/qzbd2/activity/1408/huanli.jpg", //分享图片
	"title":"金币换礼 商城好礼随你换",
	"preView":"下载亲子宝典app，参与“金币换礼”活动，商城众多母婴精选好礼即可兑换！如此省钱妙招，你怎能错过，还不赶紧来参与！",
	"wap_url":"http://play9.pcbaby.com.cn/baby140801/baby/index.jsp?toapp=1", //分享url
        showShare : 1, //是否显示分享按钮（0不显示；1显示）
        "sinaName":"@PCbaby亲子宝典" //所要@的用户，无该数据时不返回该字段
  } 
 _HTML_META_END_@*/
}}}