[[TOC]] == 一.基本约定 == {{{ 1.基本约定 1.当接口处理正常时,HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。 2.当接口处理异常时,HTTP STATUS CODE 返回给500,并且给出具体的错误信息。 { "uri" : "/intf/albums-by-type.jsp", "error-desc":"Need you follow uid.", "user-notice":"给用户的提示放在这里" }` 3.接口默认的字符编码是UTF-8,接口需要实现对req-enc和resp-enc参数的支持。在JSP的最顶部,实现类似下面的代码: String queryString = request.getQueryString(); String requestEncoding = getParam(queryString,"req_enc"); String responseEncoding = getParam(queryString,"resp_enc"); if(isNotBlank(requestEncoding)){ request.setCharacterEncoding(requestEncoding); } if(isNotBlank(responseEncoding)){ response.setCharacterEncoding(responseEncoding); } 4.所有有写操作的数据接口,必须用POST方式提交,在接口里需要判断提交方式,拒绝GET的调用请求。 5.接口中的JSON字符串,key都用双引号("")包裹,value是字符串类型时,也用双引号("")包裹;是数字类型时,不用引号 6.需要分页的接口,统一返回以下字段: pageNo,pageSize,total }}} == 二.接口列表 == === 1.0首页 === {{{ 备注:首页 接口开发:庄焕滨 请求URL: 备孕首页:http://mrobot.pcbaby.com.cn/v2/qzbd/home/1 怀孕首页:http://mrobot.pcbaby.com.cn/v2/qzbd/home/2 育儿首页:http://mrobot.pcbaby.com.cn/v2/qzbd/home/3 HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数:无 返回参数: { focus:[ { id: image: title: type:论坛(1列表、2终端);亲子学院(3列表、4终端);活动(5列表、6终端);工具(7终端);食谱(8终端);资讯(9终端);问答(10终端);百科(11终端) url:(活动、工具终端打开需要url,不需要时为空字符串) } ], recommend:[ { id: image: title: type:论坛(1列表、2终端);亲子学院(3列表、4终端);活动(5列表、6终端);工具(7终端);食谱(8终端);资讯(9终端);问答(10终端);百科(11终端) url:(活动、工具终端打开需要url,不需要时为空字符串) } ], hotChannels:[ { id: name: type: image: } ] } }}} === 2.0工具 === ==== 2.1工具首页 ==== {{{ 备注:工具类首页 接口开发:庄焕滨 请求URL:http://www.pcbaby.com.cn/app/qzbd2/app/ HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 备注:备孕日历,二胎办事指南这两个工具本地实现,其他请求html页面 请求参数: { beiyun:[ { "image": "http://www1.pcbaby.com.cn/gongju/tool_icon/10.png", "name": "备孕日历", "url": "", "uri": "pregnancy-calendar" //备孕日历跳转协议 }, { "image": "http://www1.pcbaby.com.cn/gongju/tool_icon/11.png", "name": "二胎办事指南", "url": "", "uri": "policy-search" //二胎办事指南跳转协议 }, { "image": "http://www1.pcbaby.com.cn/gongju/tool_icon/9.png", "name": "排卵期安全期", "url": "http://m.pcbaby.com.cn/tools/aqq/", //其他类型工具,url值不为空 "uri": "" //无需本地实现的工具, uri值为空 }, ... ], "huaiyun": [ ... ], "yuer": [ ... ], "qita": [ ... ] } }}} ==== 2.2其他工具 ==== {{{ 备注:其他工具 接口开发: 请求URL:(取接口2.1返回数据中,某个工具字典里对应的url值) HTTP请求方式:get 是否需要登录:否 返回格式:html页面 缓存方式:无 缓存时间:无 请求参数: }}} === 3.0每日知识 === ==== 3.0每日知识首页 ==== {{{ 备注:每日知识首页 接口开发:吴全贵 请求URL:http://baike.pcbaby.com.cn/intf/app/2.0/timeline_content_list_301.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: lemmaId:时间轴id 返回参数: { tips:"",专家提醒 ad:"",广告软文 cookbook:[ { id: image: title: des: } ], timeline:[ { "title":"优生优育", "section":[ { id: image: title: type:论坛(1列表、2终端);亲子学院(3列表、4终端);活动(5列表、6终端);工具(7终端);食谱(8终端);资讯(9终端);问答(10终端);百科(11终端) }, { id: image: title: type: } ] }, { "title":"生男生女", "section":[ { id: image: title: type: }, { id: image: title: type: } ] } ] } }}} ==== 3.1周期 ==== {{{ 备注:周期 接口开发:吴全贵 请求URL:http://baike.pcbaby.com.cn/intf/app/2.0/week_list_201.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数:无 ,接口Json由后台周期管理页面编辑所得 返回参数: { weeks:[ { num:1, tips:"多吃含钙食物" }, { num:1, tips:"多吃含tie食物" } ] } }}} ==== 3.2食谱列表 ==== {{{ 备注:食谱列表 接口开发:吕丁勤 请求URL:http://baike.pcbaby.com.cn/intf/app/2.0/cookbook_list_401.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: lemmaId:时间轴id 返回参数 { id: cookbook:[ [//第一天 { id: name: image: des: }, { id: name: image: des: }, { id: name: image: des: } ], [//第二天 { id: name: image: des: }, { id: name: image: des: }, { id: name: image: des: } ] ] } }}} ==== 3.3食谱详情 ==== {{{ 备注:食谱详情 接口开发:吕丁勤,唐良运 请求URL:http://pp.pcbaby.com.cn/template/pcbaby/intf/intfGroups4Cookbook.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: id:食谱id resp_enc:utf-8 req_enc:utf-8 例子:http://pp.pcbaby.com.cn/template/pcbaby/intf/intfGroups4Cookbook.jsp?id=23081&resp_enc=utf-8&req_enc=utf-8 返回参数 { id: name: picDes:[ { id: image: des: } ] } }}} ==== 3.2文章搜索(暂不做此功能) ==== {{{ 备注:文章搜索 接口开发:快搜 请求URL:http:// HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: id:食谱id 返回参数 { datas:[ { "cmtCount": 0, "id": "1455932", "image": "http://img0.pcbaby.com.cn/pcbaby/2tai/beiyun/zhunbei/1404/beiyun1-184128_1.jpg", "pubDate": "2014-03-27 11:56:18", "title": "为啥二胎比一胎难怀?解密真相", "url": "http://2tai.pcbaby.com.cn/145/1455932.html" } ] } }}} === 4.0交流圈 === ==== 4.1生活圈精华帖子列表 ==== {{{ 备注:生活圈帖子列表,时间倒序 接口开发:丁健勇 请求URL:http://bbs.pcbaby.com.cn/intf/forum/getPicks.do HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:有 缓存时间:1小时 请求参数: forums=1;需要查询的版块ID,多个版块ID用半角逗号分隔。查找的信息也会包含其子版块 noForums=0;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块 pickType=pickA;精华类型,可填all,pickA,pickB,pick1,pick2,pick3,pick4,pick5;其中pickA和pickB查的都是普通精华,all为查询所有精华 pageNo:当前第几页 pageSize:每页显示的数量,默认为10条 maxLength:帖子内容需要截取的长度,默认240个字节 callback:回调函数 showImage=false;显示图片 ie=gbk;输出内容的编码格式 cacheTime=3600;缓存时间,单位为秒 返回参数: { status: 0 desc: "查询成功" topics:[ { forumId: 版块id forumName: 版块名称 topicId: 帖子id title: 帖子标题 message: 帖子内容需要截取的长度,默认240个字节 authorName: 帖子的用户名 createAt: 帖子的创建时间 views: 帖子浏览数 replyCount: 帖子回复数 用户ID(新增)userId 用户昵称(新增)userName 用户头像(新增)userFaceUrl images[]帖子图片组成的数组(新增,大小为70*70) } ] } }}} ==== 4.1.1生活圈最新帖子列表 ==== {{{ 备注:生活圈最新帖子列表,时间倒序 接口开发:丁健勇 请求URL:http://bbs.pcbaby.com.cn/mobile/baby/getNewTopics.do HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:1小时 请求参数: fids:指定版块id,多个id用逗号隔开(如:fids=1776,1948,1799,1915) pageNo: pageSize: ie:产出内容的编码,默认为gbk maxLength:帖子内容需要截取的长度,默认240个字节 noFids:需要过滤的版块id,多个id用逗号隔开(如:noFids=1776,1948,1799,1915)注意:该参数只有在fid=1的时候才有效 返回参数,成功: { fids: "1771,1776", topics:[ { category: "婆媳", categoryId: 2, createAt: "2014-06-18 14:51:38", floor: 1, forumId: 1771, forumName: "女人心情", forumUrl: "http://localhost.pconline.com.cn/bbs7/forum-1771.html", images: [ "http://dev2.pconline.com.cn:9191/kidsbbs6/1406/12/c0/1205470_1402557443988_1024x1024.jpeg", "http://dev2.pconline.com.cn:9191/kidsbbs6/1406/12/c0/1205471_1402557448357_1024x1024.jpg", "http://dev2.pconline.com.cn:9191/kidsbbs6/1406/12/c0/1205479_1402559413897_1024x1024.png" ], lastPostAt: "2014-06-18 14:51:38", message: "修改分类修改分类", replyCount: 0, rewardAmount: 0, rewardRemain: 0, title: "婆媳", topicId: 1942176, topicUrl: "http://localhost.pconline.com.cn/bbs7/topic-1942176.html", userId: 826717, userName: "MyNameIsSoLongAndBig", userUrl: "http://my.pcbaby.com.cn/id/826717/bbs/", viewCount: 1, 用户头像(新增,大小为46*46) userFaceUrl } ] } }}} ==== 4.2生活圈栏目列表 ==== {{{ 备注:生活圈栏目列表 接口开发:庄焕滨 请求URL:http://www.pcbaby.com.cn/app/qzbd2/shqgd/ HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: 返回参数 { channels:[ { id: 论坛id name: 论坛名字 image: 论坛图片 des1: 论坛描述1 des2: 论坛描述2 } ] } }}} ==== 4.3帖子终端 ==== {{{ 备注:获取帖子内容 接口开发:mrobot 请求URL:http://mrobot.pcbaby.com.cn/v2/bbs/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18&is_1tai=1 HTTP请求方式:get 是否需要登录:否 返回格式:html页面 缓存方式:无 缓存时间:无 请求参数: tid:4592911 pageNo:页码 pageSize:一页条数 is_1tai:值为1时,表示请求1胎帖子终端且图片点击增加协议(协议与pcauto一样)。 设置header Cookie = "common_session_id=xxxx"; 返回参数 加入一段注释,注释内的内容为一段json /*@_HTML_META_START_ {"favoriteId":-1,"pageCount":5,"pageNo":1,"title":"3月6日北京提2012款白色三厢2.0AT旗舰型作业","userId":32031278,"webUrl":"http://bbs.pcauto.com.cn/topic-4592911.html"} _HTML_META_END_@*/ 点击图片,要有对应协议,可以参考接口: http://mrobot.pcauto.com.cn/v2/bbs/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18 url:http://piebbs.pconline.com.cn/rest/topics/${topicId} }}} ==== 4.4发帖接口 ==== {{{ http://bbs.pcbaby.com.cn/rest/forums.jsp 发帖接口 参数 forumId:板块ID title:主题标题 category:发主贴时的帖子类别 1性福,2婆媳,3情感,4职场,5姐妹,6邻里 message:内容 anonymous:是否匿名 1为匿名 0为不匿名 设置header Cookie = "common_session_id=xxxx"; 说明:POST 返回参数 { msg: result } }}} ==== 4.5回帖接口 ==== {{{ http://bbs.pcbaby.com.cn/rest/topics.jsp 回帖接口 参数 topicId:主题ID title:主题标题 message:内容 anonymous:是否匿名 1为匿名 0为不匿名 replyToId:回复楼层的id 设置header Cookie = "common_session_id=xxxx"; 说明:POST 返回参数 { msg: result: } }}} ==== 4.6上传图片 ==== {{{ 备注:上传图片 接口开发: 请求URL:http://upc.pconline.com.cn/upload_quick.jsp?application=yidong HTTP请求方式:post 是否需要登录:是 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: file:文件名称,文件本体 富文本格式传送,该接口返回图片url,其被用于回帖或者发帖中贴图。 }}} ==== 4.7私密圈帖子列表-私语 ==== {{{ 备注:私密圈帖子,时间倒序 接口开发:丁健勇 请求URL:http://bbs.pcbaby.com.cn/mobile/baby/getSecretTopics.do HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:1小时 请求参数: type:1私语(默认),2话题 pageNo: pageSize: ie:产出内容的编码,默认为gbk maxLength:帖子内容需要截取的长度,默认240个字节 返回参数,成功: { fids: "2250", topics: [ { category: "性福", categoryId: 1, createAt: "2014-06-13 11:50:22", floor: 11, forumId: 2250, forumName: "匿名板块", forumUrl: "http://localhost.pconline.com.cn/bbs7/forum-2250.html", lastPostAt: "2014-06-20 14:55:32", message: "处女贴处女贴处女贴", replyCount: 10, rewardAmount: 0, rewardRemain: 0, title: "处女贴", topicId: 1942125, topicUrl: "javascript:void(0)", userId: 826717, userName: "M***", userUrl: "http://my.pcbaby.com.cn/id/826717/bbs/", viewCount: 1 } ] } }}} ==== 4.7私密圈帖子列表-话题 ==== {{{ 备注:私密圈帖子,时间倒序 接口开发:丁健勇 请求URL:http://bbs.pcbaby.com.cn/mobile/baby/getSecretTopics.do HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:1小时 请求参数: type:1私语(默认),2话题 pageNo: pageSize: ie:产出内容的编码,默认为gbk maxLength:帖子内容需要截取的长度,默认240个字节 返回参数,成功: { fids: "2250", topics: [ { category: "性福", categoryId: 1, createAt: "2014-06-13 11:50:22", floor: 11, forumId: 2250, forumName: "匿名板块", forumUrl: "http://localhost.pconline.com.cn/bbs7/forum-2250.html", lastPostAt: "2014-06-20 14:55:32", message: "处女贴处女贴处女贴", replyCount: 10, rewardAmount: 0, rewardRemain: 0, title: "处女贴", topicId: 1942125, topicUrl: "javascript:void(0)", userId: 826717, userName: "M***", userUrl: "http://my.pcbaby.com.cn/id/826717/bbs/", viewCount: 1 } ] } }}} ==== 4.8私密圈闺蜜帖子列表 ==== {{{ 备注:私密圈闺蜜帖子,时间倒序 接口开发:丁健勇 请求URL:http://bbs.pcbaby.com.cn/mobile/getBestieTopics.do HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: ie=gbk;输出内容的编码格式 pageNo=1;当前页数 pageSize=10;一页显示的条数 maxLength=240;帖子内容摘要 callback=;回调函数名称 help=true;接口帮助 fid=;版块id 默认为私密圈对应的板块 cacheTime=3600;缓存时间,单位为秒, 返回参数 { id: name: topics:[ { pid:改回复的id topicId:原帖子的id title:标题 message:内容简介,截取正文部分内容 viewsNum:浏览数 commentNum:楼层数 categoryId:1性福,2婆媳,3情感,4职场,5姐妹,6邻里 category:对应category的名字 replyContent:回复内容 replyAuthorName:回帖用户名 replyAuthorId:回帖用户id replyTime:回复时间戳 topicAuthorId: 主贴用户id } ] } }}} ==== 4.9论坛搜索接口 ==== {{{ http://bbs.pcbaby.com.cn/mobile/searchTopics.do 通过关键字或标题搜索帖子内容,结果从快搜得到 参数 searchWord=; 关键字 pageSize,pageNo,maxLength; searchScope=1; 查找的范围,1为标题或内容,2为标题,3为内容 返回json格式 { status, total, pageSize, pageNo, topics[ { topicId, title, message, uid, createAt, view, replyCount, secretForum } ] } }}} === 5.0问答 === ==== 5.1问答搜索 ==== {{{ 备注:问答搜索 **结果显示含有专家回答的问题,样式为1个问题后跟1个答案** 接口开发:卢海潮 请求URL: 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/5 HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: keyword:关键字 pageNo pageSize 返回参数 { id: name: questions:[ { id: question:"" answer:"" authorId: authorFace: authorName: hospital: department: time: } ] } }}} ==== 5.2问答详情 ==== {{{ 备注:问答详情 **终端页只显示专家回答,普通网友回答不显示。当有几个专家回复时,优先显示已采纳的专家的回复,其他按时间排** 接口开发:卢海潮、庄焕滨 请求URL: 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/15 HTTP请求方式:get 是否需要登录:否 返回格式:HTML页面 缓存方式:无 缓存时间:无 请求参数: id:问题id 返回参数: 点击协议: pcaction://adopt-answer/id }}} ==== 5.2.1问答-采纳答案 ==== {{{ 备注:问答详情 接口开发:卢海潮 请求URL: 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/6 HTTP请求方式:POST 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: id:答案id 返回参数: { result: msg: } }}} ==== 5.3提问 ==== {{{ 备注:提问 接口开发:卢海潮 请求URL:http:// 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/7 HTTP请求方式:post 是否需要登录:是 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: title:问题标题 des = 问题描述; typeId = 问题分类id specialistId:专家id,可选 设置header Cookie = "common_session_id=xxxx"; 返回参数 { msg: result: } }}} ==== 5.4问题分类 ==== {{{ 备注:问题分类 接口开发:卢海潮 请求URL: 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/4 HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: 返回参数 { sections:[ { id: name:备孕 types:[ { id:1 name:生男生女 }, { id:2 name:孕前饮食 } ] }, { id: name:月子 types:[ { id:1 name:生男生女 }, { id:2 name:孕前饮食 } ] } ] } }}} === 6.0 个人中心 === ==== 6.1消息中心 ==== ===== 6.1.0 更新未读消息接口 ===== {{{ 备注:更新未读消息接口 接口开发:郭公仆 请求URL:http://my.pcbaby.com.cn/intf/forApp/updateNoticeStatus.jsp HTTP请求方式:post 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 备注: ids 取 接口6.1.2中返回的noticeIds 值;每次当接口6.1.2邀请成功后更新未读消息,若noticeIds 为空则可不更新 请求参数: common_sessin_id: //用户登录id ids: //消息id,用英文逗号分隔 req_enc:"UTF-8" resp_enc:"UTF-8" 返回参数: { "ret":0 } 错误 { "ret":-1, "error-desc":"用户id不能小于0" } }}} ===== 6.1.1 圈子回复数 ===== {{{ 备注:圈子回复数 接口开发:郭公仆 请求URL:http://my.pcbaby.com.cn/intf/forApp/getCount.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: common_session_id:登录用户id 返回参数 { "HTTP_STATUS_CODE": 200, "myTopicsCount": 0 } }}} ===== 6.1.2 圈子回复列表 ===== {{{ 备注: 圈子回复列表(获取主贴回复和回帖回复) 接口开发:郭公仆 请求URL:http://my.pcbaby.com.cn/intf/forApp/getSysNotice.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 备注: 1、"isPost"字段对应 : 1:主贴回复 0:回帖回复 2、当isPost = 0时增加两个字段"replyerUrl"// 回帖url ; "replyerDesc": // 回帖内容,回帖消息字段 3、当isPost=1时显示 “我的主贴”:主贴内容; 当isPost=0时显示 “我的回贴”:回贴内容 请求参数: common_session_id://登录用户id noticeTypeId: 822 //请求类型:822 主贴回复与回帖回复 resp_enc: // UTF-8 resp-en: //UTF-8 返回参数 { "desc": "暂时没有数据", "HTTP_STATUS_CODE": 200 } { "isPost": 1:主贴回复 0:回帖回复 "total":2, "noticeIds":消息id,逗号分隔 "topics": [ { "createTime":"2014-07-05 09:41:26", "title":"主帖回复", "postId":"1962806", "isPrivate":"false", 是否是私密圈 false:否,true:是 "text":"", "replyAccountId":"", "replyAccountLogo":"", // 回帖头像 "replyId":"", //回帖ID "replyUrl":"", "replyAccountUrl":"", "replyDesc":"", //isPost=1时对应回帖内容;isPost=0时对应回帖回复内容 "postDesc":"", //主贴内容 "postUrl":"", "replyAccountName":"", "replyTime":"", "replyerUrl":"", // 回帖url 当isPost=0,增加回帖消息字段 "replyerDesc": // 回帖内容 当isPost=0, 增加回帖消息字段 } { ... } ], "pageNo":1, "pageSize":6, "ret":0:正常 -1:异常或报错 } }}} ===== 6.1.3问答回复数 ===== {{{ 备注:问答回复消息数(接口无法出,改为通过读取接口:6.1.3问答回复列表,判断total值是否有改变,本地实现消息数提醒) }}} ===== 6.1.4问答回复列表 ===== {{{ 备注:问答回复列表(所有问题的回答列表) 接口开发:卢海潮 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/list_my_question_reply.jsp 接口说明 trac 地址: http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/20 HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: req_enc 请求预设编码 resp_enc 结果集预设编码 common_session_id pageNo pageSize 返回参数 { "total": 1, "pageNo": 1, "pageSize": 20, "ret": 0, "datas": //返回数据 [ { "questionID": // 问题id "title":" // 问题标题 "id": //答案id "authorFace": //专家头像 "adopted": "time":" //回答时间 "department":"营养科", //专家所在部门 "authorName": //专家名 "answer": //回答详情 "hospital": //医院名称 "authorId": //专家的id } ... ] } }}} ==== 6.2我的交流圈-主帖、精华帖、回帖 ==== {{{ 备注:我的交流圈-主帖、精华帖、回帖 接口开发:丁健勇 请求URL:http://bbs.pcbaby.com.cn/intf/user/queryUserPost.do HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 备注:添加字段 toReplyContent:引用回帖的内容(当回复是回帖的回复时,该参数不为空) 请求参数: uid: 用户id,默认为当前登录用户id type: 查询类型,默认为topic;可填topic(主贴),pick(精华帖),reply(回帖) pageNo: 当前第几页 pageSize: 每页显示的数量,默认10条 maxLength: 帖子内容需要截取的长度,默认240个字节 callback: 回调函数 ie=UTF-8;输出内容的编码格式 type为topic或pick时的返回参数,成功时: { status: 0, desc: "查询成功", uid: 用户id, topics:[ { topicId: 主帖id, title: 标题, message: 截取的帖子内容, authorName: 主帖的用户名, createAt: 发帖时间, views: 帖子浏览数, replyCount: 帖子回复数 secretForum:true 为私密 } ] } 失败时: { desc: "原因描述", status: 状态码 } type为reply时的返回参数,成功时: { status: 0, desc: "查询成功", uid: 用户id, topics:[ { topicId: 主帖id, image: 主帖中的第一张图片, title: 主帖标题, message: 截取的帖子内容, authorName: 主帖的用户名, createAt: 主帖创建时间, views: 主帖浏览数, replyCount: 主帖回复数, categoryId: 1性福,2婆媳,3情感,4职场,5姐妹,6邻里, category: 对应category的名字, replyContent: 回帖的内容, toReplyContent:引用回帖的内容(当回复是回帖的回复时,该参数不为空) replyAuthorName: 回帖的用户名, replyAuthorId: 回帖的用户id, replyTime: 回帖的时间 } ] } 失败时: { desc: "原因描述", status: 状态码 } }}} ==== 6.3我的交流圈数量 ==== {{{ 备注:我的交流圈-主贴、精华帖 接口开发:丁健勇 请求URL:http://bbs.pcbaby.com.cn/intf/user/queryUserPostCount.do HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: uid: 用户id,默认查询当前登录用户id 返回参数 { topicCount:主帖数量 pickCount:精华帖数量 replyCount:回帖数量 } }}} ==== 6.4我的问答 ==== {{{ 备注:获取我的问答信息列表 接口开发:卢海潮 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/my_questions.jsp 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/8 HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: req_enc 请求预设编码 resp_enc 结果集预设编码 common_session_id 登录用户id callback type 0 所有问题,1 已解决的问题, 2 未解决的问题 pageno pagesize 返回参数 { "pageNo":1, "pageSize":20, "questions":[ { "id":461751, "title":"测试", "time":1404957613000 } ] } }}} ==== 6.4.1我的问答数量 ==== {{{ 备注:我的问答 接口开发:卢海潮 请求URL: 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/9 HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: 设置header Cookie = "common_session_id=xxxx"; 返回参数 { solvedCount:已解决数量 unsolvedCount:未解决数量 } }}} ==== 6.4.2我的问答回复 ==== {{{ 备注:我的问答回复列表(对应单个问题) 接口开发:卢海潮 请求URL: http://kuaiwen.pcbaby.com.cn/intf/app/list_question_reply.jsp 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/18 HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: req_enc 请求预设编码 resp_enc 结果集预设编码 common_session_id callback id 问题ID 返回参数 { "id":281639, "title":"妊娠期糖尿病的孕妇可以吃市面上的无糖食品吗?这些无糖食品是不是吃多少都不用担心血糖升高的呢?", "des": //问题详情 "time" //问题发布时间 "answers":[ { "id":431361, "authorFace":"http://img.pconline.com.cn/images/upload/upc/tx/kuaiwen/1308/22/c0/24751760_24751760_1377151997062_180x180.jpg", "adopted":1, "time":"2014-01-16 16:36:32", "department":"营养科", "authorName":"潘丹峰", "answer":"无糖食品并非吃多少都没问题,市面上很多无糖食品只是不含单、双糖而已,有的无糖食品碳水化物含量也很高或含能量较高,同样也不利于血糖控制,所以选择这类食物还是要结合食物的成分、血糖指数来看。", "hospital":"广州市第一人民医院", "authorId":29743802 } ] "ret": //-1表示失败,0表示OK "msg": // 提示文字 } }}} ==== 6.4.3答案采纳 ==== {{{ 备注:我的问答回复答案采纳 接口开发:卢海潮 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/adopt_answer.jsp 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/6 HTTP请求方式:post 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: req_enc 请求预设编码 resp_enc 结果集预设编码 callback answerid questionid common_session_id 返回结果:JSON数据 { "result":0, "msg":"操作成功" } }}} ==== 6.5获取我的收藏列表 ==== {{{ 备注:我的收藏 接口开发:谢思华 请求URL:http://baike.pcbaby.com.cn/intf/app/2.0/favor_list_101.jsp HTTP请求方式:get 是否需要登录:是 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: type:收藏对象类型(0文章;5帖子;1百科;6问答;7课程;8食谱) common_session_id:登录用户id pageNo:第几页 pageSize:每页显示最大数量 返回参数 示例1:有收藏数据 { "RESPONSE_STATUS" = 200; //200 网络正常; 500 网络错误 collections:[ { id:收藏对象标识码 title:文章标题 } pageNo = 1; pageSize = 10; total = 1; ] } 示例2:无收藏 { "RESPONSE_STATUS" = 200; msg = "找不到已收藏的列表"; result = 0; } 示例3:错误请求 { "RESPONSE_STATUS": 500, "error-desc": "internal accountId,type", "uri": "intf/app/2.0/favor_list_101.jsp", "user-notice": "参数为空或不合法,或未登录" } }}} ==== 6.5.1是否已收藏 ==== {{{ 备注:是否已收藏 接口开发:谢思华 请求URL:http://baike.pcbaby.com.cn/intf/app/2.0/favor_iscollect_104.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: 设置header Cookie = "common_session_id=xxxx" type:收藏对象类型(0文章;5帖子;1百科;6问答;7课程;8食谱) id:收藏对象标识码 返回参数 { msg: //提示信息 “已收藏”、“未收藏” result: //状态码 1:正常返回 ; 0: 返回错误 } 结果示例: { "msg":"已收藏", "result":"1" } { "msg":"未收藏", "result":"1" } }}} ==== 6.6删除收藏 ==== {{{ 备注:删除收藏 接口开发:谢思华 请求URL:http://baike.pcbaby.com.cn/intf/app/2.0/favor_uncollect_103.jsp HTTP请求方式:post 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: type:收藏对象类型(0文章;5帖子;1百科;6问答;7课程;8食谱) common_session_id:登录用户id token:设备唯一号 id:收藏对象标识码 返回参数 { msg: //提示信息 result: //1:取消收藏成功; 0:该文章不存在或已取消收藏 } }}} ==== 6.7添加收藏 ==== {{{ 备注:添加收藏 接口开发:谢思华 请求URL:http://baike.pcbaby.com.cn/intf/app/2.0/favor_collect_102.jsp HTTP请求方式:post 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: 设置header Cookie = "common_session_id=xxxx" type:收藏对象类型(0文章;5帖子;1百科;6问答;7课程;8食谱) token:设备唯一号 id:收藏对象标识码 title:文章标题 返回参数:JSON { "msg":"提示信息", "result":"1/0" } 结果示例: { "msg":"收藏成功", "result":"1" } { "msg":"用户已收藏该文章", "result":"0" } }}} ==== 6.8获取用户积分 ==== {{{ 备注:获取用户积分 接口开发: 请求URL:http://bbs.pcbaby.com.cn/action/score/get.jsp HTTP请求方式:get 是否需要登录:是 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: uid=; //用户ID(not null) scoretypeid=11; //金币类型id 11为金币; 22为积分 (这里传11,获取金币) 返回参数:JSON { status, desc, userId, score } }}} === 7.0亲子学院 === ==== 7.1亲子学院首页列表 ==== {{{ 备注:亲子学院首页列表 接口开发:苏榕 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/course_index.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: req_enc 请求预设编码 resp_enc 结果集预设编码 返回参数 { "sections": [ { "typeid": 1, "typename": "123", "course": [ { "videoid": 21, "videotitle": "测试1", "videourl": "" } ] }, { "typeid": 11, "typename": "测试1", "course": [ ] }, { "typeid": 12, "typename": "测试2", "course": [ ] }, { "typeid": 13, "typename": "12", "course": [ ] }, { "typeid": 14, "typename": "测试3", "course": [ ] }, { "typeid": 21, "typename": "测试5", "course": [ ] } ] } }}} ==== 7.2亲子学院搜索 ==== {{{ 备注:亲子学院搜索 接口开发:苏榕 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/course_search.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: req_enc 请求预设编码 resp_enc 结果集预设编码 keyword 关键词 pageNo pageSize 返回参数 { "total": 3, "pageNo": 1, "pageSize": 10, "course": [ { "videoId": 32, "videoTitle": "测试3", "videoUrl": "" }, { "videoId": 31, "videoTitle": "测试2", "videoUrl": "" }, { "videoId": 21, "videoTitle": "测试1", "videoUrl": "" } ] } }}} ==== 7.3课程详情 ==== {{{ 备注:亲子学院课程详情 接口开发:苏榕 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/course_detail.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: req_enc 请求预设编码 resp_enc 结果集预设编码 id 视频id 返回参数 { "id":21, "positionalTitles":"医疗总监", "des":"", "title":"测试1", "expertFace":"http://i1.3conline.com/images/upload/upc/face/27/33/74/64/27337464_180x180", "expertId":27337464, "expertName":"夏凯莉", "expertDes":"资深专家", "hospital":"广州和睦家医疗", "url":"", "questions":[ { "id":281765, "authorFace":"http://i1.3conline.com/images/upload/upc/face/29/74/38/02/29743802_180x180", "time":"2014-01-16 16:52:08", "department":"营养科", "authorName":"潘丹峰", "answer":"控制饮食的同时,最好结合适当的运动。可在餐后一小时后进行散步、做操等较为轻松缓和的活动,避免剧烈的运动,运动的持续时间不宜过长,一般20-30分钟左右,而且在运动过程当中应注意观察有没有宫缩,如果感到疲劳、有宫缩要马上休息。有先兆早产或者其它严重并发症者不宜运动。监测血糖的频率请遵医嘱。", "question":"在控制饮食的同时,是否需要结合运动?需要每天监测血糖的变化吗?", "hospital":"广州市第一人民医院", "authorId":29743802 }, { "id":281805, "authorFace":"http://i1.3conline.com/images/upload/upc/face/29/74/38/02/29743802_180x180", "time":"2014-01-16 16:58:48", "department":"营养科", "authorName":"潘丹峰", "answer":"不吃早饭是不合适的。建议早餐选用血糖指数低的食物。", "question":"我早晨的血糖比较高,但是到了下午和晚上血糖比较低,可以早饭不吃,其他时间正常饮食来控制吗?", "hospital":"广州市第一人民医院", "authorId":29743802 } ] } }}} ==== 7.4相关问答 ==== {{{ 备注:相关问答 接口开发:苏榕 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/course_relate_question.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: req_enc 请求预设编码 resp_enc 结果集预设编码 id 视频ID pageno pagesize 返回参数 { "id": 21, "total": 1322, "pageNo": 1, "name": "测试1", "pageSize": 2, "questions": [ { "id": 347921, "authorFace": "http://i1.3conline.com/images/upload/upc/face/29/43/43/88/29434388_180x180", "time": "2014-03-25 20:05:19", "department": "产科", "authorName": "缪缙", "answer": "你好,请问你具体想咨询些什么呢。", "question": "妇科病病妇科病病妇科病病", "hospital": "暨南大学附属第一医院", "authorId": 29434388 }, { "id": 20498, "authorFace": "http://i1.3conline.com/images/upload/upc/face/26/85/23/20/26852320_180x180", "time": "2013-05-06 17:53:58", "department": "", "authorName": "我是婷婷婷", "answer": "大型的医院收费可能相对普通医院要贵一些,但是医生的临床经验,医院的设备自然也是要一流一些,另外怀孕期间最好不要做太多次B超。特别是不要在孕早期做过多的B超,会影响宝宝的正常发育的。", "question": "请问去做b超检查时,在综合型的大医院的妇科检查好,还是在专门的妇科医院检查就行?费用会有很大的差距吗?", "hospital": "", "authorId": 26852320 } ] } }}} ==== 7.5专家介绍 ==== {{{ 备注:专家介绍 接口开发:卢海潮、庄焕滨 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/course_expert_introduce_html.jsp?id=29743802 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/16 HTTP请求方式:get 是否需要登录:否 返回格式:HTML页面 缓存方式:无 缓存时间:无 请求参数: id:专家id 点击协议 向TA提问按钮点击协议 pcbabybible://ask-expert/id }}} ==== 7.6视频介绍 ==== {{{ 备注:视频介绍 接口开发:卢海潮、庄焕滨 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/course_introduce_html.jsp?id=21 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/17 HTTP请求方式:get 是否需要登录:否 返回格式:html页面 缓存方式:无 缓存时间:无 请求参数: id 视频ID }}} === 8.0活动 === ==== 8.1活动首页 ==== {{{ 备注:活动首页 接口开发: 请求URL: HTTP请求方式:get 是否需要登录:否 返回格式:HTMl页面 缓存方式:无 缓存时间:无 请求参数: 返回参数: pcbabybrowser://baby-webview/?url=http://xxxx&title=每日签到 }}} === 9.0二胎政策 === {{{ 2胎政策部分使用接口文档: http://trac.pc.com.cn/iphone/wiki/2ndchild/interface }}} === 9.1 亲子宝典一/二胎 资讯 === {{{ 参照接口文档 http://trac.pc.com.cn/iphone/wiki/2ndchild/interface }}} ==== 9.1.1 亲子宝典一/二胎怀孕文章栏目 ==== {{{ URL:http://mrobot.pcbaby.com.cn/configs/pcbaby_qzbd_cms_iphone_channel_tree 作用:资讯栏目 提交方式:GET 参数:无 返回结果:JSON { "1tai": [ { "id": 1, "title": "头条" }, { "id": 2, "title": "怀孕" }, { "id": 3, "title": "产后" }, { "id": 4, "title": "育儿" } ], "2tai": [ { "id": 1, "title": "头条" }, { "id": 2, "title": "备孕" }, { "id": 3, "title": "孕育" }, { "id": 4, "title": "高龄产妇" } ] } }}}