[[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 返回参数: { 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": [ //每日知识内容 { "section": [ //发育指标 { "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" } ], "sectionListCount": 1, "title": "发育指标" }, { "section": [ //知识点概括 { "description": "进入孕后期,你可能会感到尿频和总有尿不完的感觉。这个阶段有将近80%的孕妇为尿频困扰,很多孕妈妈在夜间需要更频繁地起床跑厕所。", "id": 511, "title": "孕妇尿频", "type": "11" }, { "description": "孕期气短通常没有什么大碍,也很正常。在日常生活中把节奏放慢一些,活动或运动的时候,不要太勉强自己。", "id": 633, "title": "孕妇气短", "type": "11" } ], "sectionListCount": 4, "title": "准爸准妈必读" } ], 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 私密圈帖子,type=10 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: //标题 articleId: //文章id expertName: //专家名 position:"副主任医师" //职位 department: "儿科", //科室 }, { type:4 //类型:问答专栏 image: "http://www1.pcbaby.com.cn/03daodu.jpg", title: "孩子经常发烧怎么办?", preview:"孩子经常发烧" //简介 articleId: "2042246", //文章id num: "3", //专栏期数id expertId: "29003920" //专家id }, { type:5 //类型:精彩活动 image: "http://www1.pcbaby.com.cn/03daodu.jpg", url:// 活动页面url }, { type:6 //类型:资讯文章 image: "http://www1.pcbaby.com.cn/03daodu.jpg", title: "孩子经常发烧怎么办?", preview:"孩子经常发烧" //简介 articleId: "2042246" //文章id }, { type:7 //类型:百科文章 image: "http://www1.pcbaby.com.cn/03daodu.jpg", title: "孩子经常发烧怎么办?", preview:"孩子经常发烧" //简介 url: "http://baike.pcbaby.com.cn/app/zsd/1190.html" //百科文章url }, { type:8 //类型:生活圈帖子 image: "http://www1.pcbaby.com.cn/03daodu.jpg", title: "孩子经常发烧怎么办?", preview:"孩子经常发烧" //简介 topicId: 2155710, //帖子ID }, { type:9 //类型:私密圈帖子 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 }, } ], 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" } ] } }}}