[[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": "24042", //焦点图id "image": "http:xxx", //焦点图url "title": "细说人流后的大姨妈", //焦点图标题 "type": "9", //约定跳转协议:论坛(type=1论坛列表、type=2论坛终端);亲子学院(3列表、4终端);活动(5列表、6终端);工具(7终端);食谱(8终端);资讯(9终端);问答(10终端);百科(11终端) "url": "" (type为6、7,即活动和工具终端页面时候,该字段存在且有URL,该URL为跳转的网页URL。type为其它时,URL为空) } ], recommend:[ //四个推荐位数据,取返回的前四组数据 { "id": "981700", //推荐位内容id "image": "http://xxx ", //推荐位图片 "title": "不同体质的孕前调理", //推荐位标题 "type": "9",论坛(1列表、2终端);亲子学院(3列表、4终端);活动(5列表、6终端);工具(7终端);食谱(8终端);资讯(9终端);问答(10终端);百科(11终端) "url": "" ( type为6、7,即活动和工具终端页面时候,该字段存在且有URL,该URL为跳转的网页URL。type为其它时,URL为空) } ], "recommendChannel": [ { //热门栏目数据, "title": "交流圈",//栏目标题,app端通过判断栏目标题显示虽要推荐的栏目 }, …… ], topFocus: [ //焦点图广告,如果有广告数据则根据seq值替换掉原来focus中对应位置的数据 { cc-uri: "", //点击计数标签:点击一次,计数一次 image: "http://xxx ", //广告图片 seq: 1, //广告在焦点图中的插入位置 title: "广告", //标题 to-uri: "http://xxx ", //广告跳转url updateAt: 1408678837215, //广告更新时间 vc-uri: "none" //显示计数标签:显示一次,计数一次 } ] } }}} ==== 1.1每日一笑 ==== {{{ 请求url:http://baike.pcbaby.com.cn/intf/app/launch_101.jsp?REQUEST_CODE=101, HTTP请求方式:get 是否需要登录:否 返回格式:json, 返缓存方式:无, 缓存时间:无, 请求参数: /REQUEST_CODE=101 //请求状态码 说明:无 返回结果: { "RESPONSE_CODE": 101, "RESPONSE_INFO": { "launchImg":"http://www1.pcbaby.com.cn/meiriqingsongyike/75.jpg" //图片链接 }, "RESPONSE_STATUS":100 } }}} ==== 1.2启动广告 ==== {{{ 请求url:http://mrobot.pcbaby.com.cn/v3/ad HTTP请求方式:get 是否需要登录:否 返回格式:json 返缓存方式:无 缓存时间:无 请求参数:无 说明:无 返回结果: { "pckids.app.qzbd.zx.qp.": { "ad": { "cc-uri": "", "cc3d-uri":"", "img":"http://imgad0.pcauto.com.cn/ivy/image/20149/5/14099100976890.jpg", "to-uri":"", "vc-uri":"http://ivy.pcauto.com.cn/adpuba/show?adid=333659&id=auto.khd.zx.qdtdh.&media=js", "vc3d-uri":"" }, "rule": { "age":3, "delay":0, "interval":0 } } } }}} === 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.1每日知识首页 ==== {{{ 备注:每日知识首页 接口开发:吴全贵 请求URL:http://baike.pcbaby.com.cn/intf/app/2.0/timeline_content_list_301.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: lemmaId:时间轴id(详情见trac《时间轴ID-65个.xls》) 返回参数: { tips: //专家提醒数据 [ { "day": "第1天", //当前天数 "expertname": "高羽", //专家名 "experttitle": "副主任医师", //专家级别 "tip": "受孕是复杂的生理过程,孕前先检查生育条件,调理到最佳再备孕。" //提醒内容 } …… ], ad:[ // 广告数据 { "content": "",//广告内容 "url": "" //广告跳转url } ], cookbook:[ //今日食谱数据 { "day": "第1天", //当前天数 "detail": [ { "des": "薏米银耳羹", //食谱详情 "id": 21739, //食谱id "image": "http://xxx", //食谱图片 "title": "银耳薏米汤" //食谱标题 }, { "des": "宫寒会", "id": 24339, "image": "http://xxx", "title": "饮食驱宫寒有助女性受孕" } ] }, …… ], timeline:[ //每日知识内容(1、备孕状态知识点:优生优育、生男生女、生育政策;2、怀孕状态知识点:发育指标、准爸准妈必读、胎教小课堂;3、育儿状态知识点:发育指标、爸妈必读、早教小课堂。其他内容忽略) { "title":"优生优育", //分组知识点标题 "sectionListCount":3, //知识点数目 "section":[ { "description": "吸烟和蒸浴都会影响精子质量",//内容 "id": 1239, //id "image": "http://xxx",//图片 "title": "提高精子质量",//标题 "type": "11" //跳转规则:论坛(1列表、2终端);亲子学院(3列表、4终端);活动(5列表、6终端);工具(7终端);食谱(8终端);资讯(9终端);问答(10终端);百科(11终端) }, …… ] }, { "title":"生男生女", //分组知识点标题 "sectionListCount":3, //知识点数目 "section":[ { "description": "生男孩的特征是脉象较强",//内容 "id": 442, //id "image": "http://xxx",//图片 "title": "生男孩的特征",//标题 "type": "11" //跳转规则:论坛(1列表、2终端);亲子学院(3列表、4终端);活动(5列表、6终端);工具(7终端);食谱(8终端);资讯(9终端);问答(10终端);百科(11终端) }, …… ] }, …… ] } }}} ==== 3.2周期 ==== {{{ 备注:周期 接口开发:吴全贵 请求URL:http://baike.pcbaby.com.cn/intf/app/2.0/week_list_201.jsp // 食谱周期列表(每日食谱周期) http://baike.pcbaby.com.cn/intf/app/2.0/knowledge_week_list_202.jsp //每日知识周期列表(怀孕与育儿状态下的知识周期) HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数:无 ,接口Json由后台周期管理页面编辑所得 返回参数: { weeks:[ //怀孕周期数据 { lemmaId:1, //时间轴id tips:"多吃含钙食物" //专家提示 }, { lemmaId:2, tips:"多吃含tie食物" } ], babyweeks:[ //宝宝周期数据 { lemmaId:41, tips:"多吃含钙食物" }, { lemmaId:42, tips:"多吃含tie食物" } ] } }}} ==== 3.3食谱列表 ==== {{{ 备注:食谱列表 接口开发:吕丁勤 请求URL:http://baike.pcbaby.com.cn/intf/app/2.0/cookbook_list_401.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: lemmaId:时间轴id 返回参数 { "id":41 //时间轴id, 41表示第一周宝宝 "cookbook":[ { "day":"第1天", //一周中的第几天 "detail":[ { "id":23981, //图片id,这个也是食谱id "name":"产后第一天膳食安排", //标题 "image":"http://xxx", //取的是中图normalUrl的值 "des":"对于顺产妈妈" //图片描述 } …… ] } …… ] } }}} ==== 3.4食谱详情 ==== {{{ 备注:食谱详情 接口开发:吕丁勤,唐良运 请求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": 22056, //食谱id "name": "益母木耳汤", //图片名 "picDes": [ { "des": "这道益母木耳", //图片描述 "id": 268101, //图片id "image": "http://xxx " //图片url }, …… ], "cover":"" //封面图 } }}} ==== 3.5文章搜索(暂不做此功能) ==== {{{ 备注:文章搜索 接口开发:快搜 请求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= 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) pageNo:当前第几页 pageSize:每页显示的数量,默认为10条 maxLength:帖子内容需要截取的长度,默认240个字节 showImage=true;显示图片 ie=utf-8;输出内容的编码格式 cacheTime=1200;缓存时间,单位为秒 返回参数: { desc: "查询成功", //状态描述 pageNo: 1, //页码 pageSize: 20, //每页条数 status: 0, //状态码 topics: [ { createAt: "2015-01-11 19:30:35", //帖子的创建时间 forumId: 1917, //版块id forumName: "宝宝秀场", //版块名称 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" ], message: " 《雯雯 萌萌哒》超级可爱的萌妹子,完全可以萌化到心底里...", //帖子内容 pickTypes: { //暂无用到参数 pick: 2, pick1: 0, pick2: 0, pick3: 1, pick4: 0, pick5: 0 }, replyCount: 2, //帖子回复数 title: "超可爱萌妹子融化人心", //帖子标题 topicId: 2155848, //帖子id userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/12/65/76/7/1265767_70x70", //用户头像 userId: 1265767, //用户ID userName: "啃蘋果的壞蛋", //用户昵称 views: 22 //帖子浏览数 } ], total: 515 //总帖子数 } }}} ==== 4.1.1生活圈最新帖子列表 ==== {{{ 备注:生活圈最新帖子列表,时间倒序 接口开发:丁健勇 请求URL:http://bbs.pcbaby.com.cn/mobile/baby/getNewTopics.do HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:1小时 请求参数: fids://指定版块id(生活圈最新的fids为1) pageNo: pageSize: ie:utf-8 //产出内容的编码,默认为gbk maxLength:帖子内容需要截取的长度,默认240个字节 noFids:需要过滤的版块id,多个id用逗号隔开(如:noFids=1776,1948,1799,1915)注意:该参数只有在fid=1的时候才有效 返回参数,成功: { fids: "1", //版块id pageNo: 1, pageSize: 20, topics: [ { category: "原创", //类别 categoryId: 0, //类别ID createAt: "2015-01-11 15:17:20", //发帖时间 floor: 4, //楼层数 forumId: 1799, //版块ID forumName: "晒货殿堂", //版块名称 forumUrl: "http://bbs.pcbaby.com.cn/forum-1799.html", //版块URL images: [ //图片数组 "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c0/1744371_1420960548132_1024x1024.jpg", "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c0/1744396_1420960565348_1024x1024.jpg", "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c0/1744430_1420960630651_1024x1024.jpg" ], lastPostAt: "2015-01-11 21:49:58", //最后回帖时间 message: "金币兑换的活动被我赶上好时候了。", //内容 replyCount: 3, //回复数 rewardAmount: 0, //未使用参数 rewardRemain: 0, //未使用参数 title: "【金币兑换】终于收到宝贝与我!", //标题 topicId: 2155710, //帖子ID topicUrl: "http://bbs.pcbaby.com.cn/topic-2155710.html", //帖子URL userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/25/23/72/54/25237254_50x50", //用户头像 userId: 25237254, //用户ID userName: "馨悦妈妈", //用户昵称 userUrl: "http://my.pcbaby.com.cn/id/25237254/bbs/", //用户URL viewCount: 20 //帖子查看数 } ], total: 639 //总条数 } }}} ==== 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/2155848?pageNo=1&size=17&picRule=2 HTTP请求方式:get 是否需要登录:否 返回格式:html页面 缓存方式:无 缓存时间:无 请求参数: /topics/2149994:帖子id; size:帖子内容字体大小; pageNo:当前所在页数; picRule:图片默认显示规则,0为显示小图,1为显示文字链接;2为显示大图。 设置header Cookie = "common_session_id=xxxx"; 返回参数 加入一段注释,注释内的内容为一段json /*@_HTML_META_START_ { "countAndroid":5772, "countIphone":5768, "pageCount":1, "pageNo":1, "title":"超可爱萌妹子融化人心", "userId":1265767,"webUrl":"http://bbs.pcbaby.com.cn/topic-2155848.html" } _HTML_META_END_@*/ }}} ==== 4.4发帖接口 ==== {{{ http://bbs.pcbaby.com.cn/rest/forums.jsp 发帖接口 参数 forumId:板块ID //(说明:从论坛列表进入某个论坛时能获得改论坛的ID。发帖是在某个论坛内发帖的,该ID为这个论坛的ID,即从论坛列表进入时可获得。私密圈版块ID为2270) title:主题标题 message:正文内容 agent:终端类型(WAP:1、iOS:2、ANDROID:3) anonymous:是否匿名 1为匿名 0为不匿名 category:发主贴时的帖子类别 1性福,2婆媳,3情感,4职场,5姐妹,6邻里(可选参数,只有在私密圈,即版块ID为2270时使用。) 设置header Cookie = "common_session_id=xxxx"; 说明:POST 返回参数 帖成功,返回HTTP响应头为201,即内容创建成功 { "Location": "http://bbs.pcbaby.com.cn/topic-2156187.html", //帖子URL "goldCount": 1, //发帖获得金币数量 "hasGold": true //发帖是否获得金币 } }}} ==== 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"; (说明:“common_session_id=F7944998D4C5E2F849C085976791BE51FA2F3CE3A5F6D159”是用户登录后得到的身份ID。大部分需要以登录身份操作的接口都需要将该值作为请求HTTP头中的Cookie值传入) 发帖成功,返回HTTP响应头为201,即内容创建成功 返回参数 { "Location": "http://bbs.pcbaby.com.cn/post-2156187_39095567.html" } }}} ==== 4.6上传图片 ==== {{{ 备注:上传图片,返回json数据有多张不同尺寸大小的图片,可根据业务需求选择使用 接口开发: 请求URL:http://upc.pcbaby.com.cn/upload_quick.jsp?command=6004&command=6005&command=6006&command=4&keepSrc=yes&application=kidsbbs6 HTTP请求方式:post 是否需要登录:是 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: file:文件名称,文件本体 富文本格式传送,该接口返回图片url,其被用于回帖或者发帖中贴图。 设置header Cookie = "common_session_id=xxxx"; 返回参数: { "files": [ { "fileSize": 4368, //文件大小 "exif": "", //exif信息 "height": 80, //图片宽度 "rid": 9990346, //未使用参数 "width": 120, //图片宽度 "fileName": "1780739_1421043128740_120x80.jpg", //文件名 "audit": "New", //未使用参数 "orgFileName": "test.jpg", //未使用参数 "isorg": 0, //未使用参数 "url": "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/12/c0/1780739_1421043128740_120x80.jpg" //图片URL } ], "retCode": 0, //状态码 "tid": 1780739 //未使用参数 } }}} ==== 4.7私密圈帖子列表-私语 ==== {{{ 备注:私密圈帖子,时间倒序 接口开发:丁健勇 请求URL:http://bbs.pcbaby.com.cn/mobile/baby/getSecretTopics.do HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:1小时 请求参数: type:1私语(默认),2话题 pageNo:1 //页码 pageSize:20 //每页条数 ie: UTF-8 //产出内容的编码,默认为gbk maxLength:240 //帖子内容需要截取的长度,默认240个字节 cacheTime:0 //缓存时间 返回参数,成功: { fids: "2270", //论坛版块ID pageNo: 1, //页码 pageSize: 20, //每页条数 topics: [ { category: "性福", //类别名称 categoryId: 1, //类别ID createAt: "2015-01-12 14:34:15", //发帖时间 floor: 1, // 楼层数 forumId: 2270, //论坛版块ID forumName: "匿名板块", //论坛版块名 forumUrl: "http://bbs.pcbaby.com.cn/forum-2270.html", //论坛版块URL lastPostAt: "2015-01-12 14:34:15", //帖子最后回复时间 message: "有没有姐妹满月了就同房的呀,老公都憋了几个月了,呵呵", //帖子内容 replyCount: 0, //帖子回复数 rewardAmount: 0, //未使用参数 rewardRemain: 0, //未使用参数 title: "有没有姐妹满月了就同房的呀,老公都憋了几个月了,呵呵", //标题 topicId: 2156386, //帖子ID topicUrl: "javascript:void(0)", //帖子URL userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/34/42/70/94/34427094_50x50", //用户头像 userId: 34427094, //用户ID userName: "q***", //用户昵称 userUrl: "http://my.pcbaby.com.cn/id/34427094/bbs/", //用户URL viewCount: 2 //帖子浏览数 } ], total: 15163 //总数量 } }}} ==== 4.8私密圈帖子列表-话题 ==== {{{ 备注:私密圈帖子,时间倒序 接口开发:丁健勇 请求URL:http://bbs.pcbaby.com.cn/mobile/baby/getSecretTopics.do HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:1小时 请求参数: type:2 //1私语(默认),2话题 pageNo: pageSize: ie:产出内容的编码,默认为gbk maxLength:帖子内容需要截取的长度,默认240个字节 cacheTime:1200 //缓存时间 返回参数,成功: { fids: "2270", //论坛版块ID pageNo: 1, //页码 pageSize: 1, //每页条数 topics: [ { category: "姐妹", //类别 categoryId: 5, //类别ID createAt: "2015-01-12 10:27:03", //发帖时间 floor: 32, //楼层数 forumId: 2270, //论坛版块ID forumName: "匿名板块", //版块名 forumUrl: "http://bbs.pcbaby.com.cn/forum-2270.html", //版块URL lastPostAt: "2015-01-12 14:27:29", //最后回帖时间 message: "【沙发王】抢沙发赢烤箱豪华大礼", //帖子内容 replyCount: 31, //帖子回复数 rewardAmount: 0, //未使用参数 rewardRemain: 0, //未使用参数 title: "【沙发王】抢沙发赢烤箱豪华大礼", //帖子标题 topicId: 2156017, //帖子ID topicUrl: "http://bbs.pcbaby.com.cn/topic-2156017.html", //帖子URL userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/28/10/47/07/28104707_50x50", //用户头像 userId: 28104707, //用户ID userName: "情感小编", //用户昵称 userUrl: "http://my.pcbaby.com.cn/id/28104707/bbs/", //用户URL viewCount: 96 //帖子被阅读数 } ], total: 74 //总条数 } }}} ==== 4.9私密圈闺蜜帖子列表 ==== {{{ 备注:私密圈闺蜜帖子,时间倒序 接口开发:丁健勇 请求URL:http://bbs.pcbaby.com.cn/mobile/getBestieTopics.do HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: ie=utf-8;输出内容的编码格式 pageNo=1;当前页数 pageSize=10;一页显示的条数 maxLength=240;帖子内容摘要 callback=;回调函数名称 help=true;接口帮助 fid=;版块id 默认为私密圈对应的板块 cacheTime=3600;缓存时间,单位为秒, 返回参数 { id: 2270, //版块ID name: "匿名板块", //版块名 pageNo: 1, //页码 pageSize: 20, //每页条数 topics: [ { category: "情感", //分类 categoryId: 3, //分类ID commentNum: 6, //帖子评论数 message: "常常会想一个问题就是如果我不幸离世了,我的老公...", //主贴内容 pid: 38973856, //未使用参数 replyAuthorId: 29503245, //回帖用户ID replyAuthorName: "艾***", //回帖用户昵称 replyContent: "我觉得大部分女人都会比较希望老公终身不娶,说明他对你感情的专一! 我曾跟我老公说,我会努力活着,不会离婚不会死,不会让别的女人住我的房子,苦我的女儿!", //回帖内容 replyTime: 1420790175000, //回帖时间 source: 0, //未使用参数 title: "常常会想一个问题就是如果我不幸离世了,我的老公会怎么做?马上就找一个还是终身不娶?后者是不会了,他还是会好好的过他的生活", //主贴标题 toReplyContent: "", //未使用参数 topicAuthorId: 34397437, //主贴用户ID topicId: 2151480, //帖子ID viewsNum: 33 //帖子查看数量 } ], total: 1149 //总条数 } }}} ==== 4.10论坛搜索接口 ==== {{{ http://bbs.pcbaby.com.cn/mobile/searchTopics.ajax 通过关键字或标题搜索帖子内容,结果从快搜得到 请求方式:get 请求参数: searchWord; //搜索关键字 pageSize=20, //每页条数 pageNo=1, //页码 maxLength=240; //内容摘要长度,固定为240 searchScope=1; 查找的范围,1为标题或内容,2为标题,3为内容(默认使用1) ie=utf-8 //返回数据编码格式 返回json格式 { pageNo: 1, //页码 pageSize: 20, //每页条数 status: 0, //状态码 topics: [ { createAt: 1419924462000, //发帖时间 message: "奶瓶作为宝宝最亲密无间的伙伴,也是继母乳后第一种输送宝宝口粮的的重要用具,已成为生活中不可或缺的一部分。 在宝宝出生前的选择小心翼翼,市场上的奶瓶多如牛毛,质量更是 良莠参半,令我这个当妈妈的更需要用心甄别 。然而对于乐扣品牌最熟悉不过,家...", //帖子内容 replyCount: 4, //帖子回复数 secretForum: false, //是否为私密圈帖子 title: "【2014亲子导购达人晒场】来自星星的Hello Bebe宽口径经典款耐热玻璃奶瓶", //帖子标题 topicId: 2140243, //帖子ID uid: 28547166, //发帖用户ID view: 4 //帖子查看数量 } ], total: 1536 //总条数 } }}} === 5.0问答 === ==== 5.1问答搜索 ==== {{{ 备注:问答搜索 **结果显示含有专家回答的问题,样式为1个问题后跟1个答案**,问答搜索JSON数据,只搜索专家数据(医生、编辑、优秀达人),目前只提供给APP使用。 接口开发:卢海潮 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/search_question.jsp 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/5 HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: keyword:关键字 pageNo pageSize 返回参数 { "total":10, //总记录数 "pageNo":1, //页码 "pageSize":20, //每页显示条数 "questions":[ { "id":172315,//问题id "authorFace":"http://img.pcbaby.com.cn/images/upload/upc/tx/pcbabyfk/1412/18/c0/793654_1418869304618_180x180.jpg", //回答者头像(180x180) "time":"2013-12-04 16:48:05", //回答时间 "department":"妇产科", //回答专家科室 "authorName":"汪星星", //回答者姓名 "answer":"你好,怀孕有褐色分泌物出现考虑很少量出血所致,是有先兆流产迹象的,", //答案内容 "question":"你好!我怀孕以经有43天了,但是去医院做B超没有怀孕,验血说怀孕了!验尿说也怀孕了!但是下面还岀血", //问题标题 "hospital":"广州医学院荔湾医院", //回答专家所在医院 "authorId":29808616 //回答者用户ID } , …… ] } }}} ==== 5.2问答详情 ==== {{{ 备注:问答详情 **终端页只显示专家回答,普通网友回答不显示。当有几个专家回复时,优先显示已采纳的专家的回复,其他按时间排** 接口开发:卢海潮、庄焕滨 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/course_question_detail_html.jsp?id=281805 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/15 HTTP请求方式:get 是否需要登录:否 返回格式:HTML页面 缓存方式:无 缓存时间:无 请求参数: id:问题id }}} ==== 5.2.1问答-采纳答案 ==== {{{ 备注:问答详情 接口开发:卢海潮 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/adopt_answer.jsp 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/6 HTTP请求方式:POST 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: answerid - 答案id questionid - 问题id common_session_id 需通行证登录,用户cookie 返回参数: { result: 0, //0=成功,其他为失败 msg:”操作成功” //提示信息 } }}} ==== 5.3提问 ==== {{{ 备注:提问 接口开发:卢海潮 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/ask.jsp 接口说明:http://rdtrac.pc.com.cn/kuaiwen_baby/ticket/7 HTTP请求方式:post 是否需要登录:是 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: title:问题标题d des = 问题描述; typeId = 问题分类id specialistId:专家id,可选 agent=1 //表示来自《亲子宝典APP》的提问 设置header Cookie = "common_session_id=xxxx"; 返回参数 { msg: ”操作成功”, //提示信息 result: 0 //0表示成功,其他为失败 } }}} ==== 5.4问题分类 ==== {{{ 备注:问题分类 接口开发:卢海潮 请求URL:http://kuaiwen.pcbaby.com.cn/intf/app/list_question_type.jsp 接口说明: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.1 更新未读消息接口 ===== {{{ 备注:更新未读消息接口 接口开发:郭公仆 请求URL:http://my.pcbaby.com.cn/intf/forApp/updateNoticeStatus.jsp HTTP请求方式:post 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 备注: ids 取 接口6.1.3中返回的noticeIds 值;每次当接口6.1.3邀请成功后更新未读消息,若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.2 圈子回复数 ===== {{{ 备注:圈子回复数 接口开发:郭公仆 请求URL:http://my.pcbaby.com.cn/intf/forApp/getCount.jsp HTTP请求方式:get 是否需要登录:是 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: req_enc: 请传UTF-8 resp_enc: 请传UTF-8 common_session_id:登录用户id 返回参数 { "ret": 1, //返回状态,1=成功,-1=失败 "myTopicsCount": 10, //圈子回复数 "error-desc": "提示信息" //错误提示信息 } }}} ===== 6.1.3 圈子回复列表 ===== {{{ 备注: 圈子回复列表(获取主贴回复和回帖回复) 接口开发:郭公仆 请求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=主贴回复,823=回帖回复 resp_enc: // UTF-8 resp-en: //UTF-8 返回参数 { "isPost":1, //1=主贴回复,0=回帖回复 "total": 10, //总数量, "noticeIds":”1101,1102”, //消息id,逗号分隔 "topics": [ { "createTime":"2014-07-05 09:41:26", //系统通知时间 "title":"系统通知", //系统通知标题 "postId":"1962806",//论坛帖子ID "isPrivate":"false", //是否是私密圈 false:否,true:是 "text":"", "replyAccountId":"", //回帖者用户ID "replyAccountLogo":"", // 回帖头像 "replyId":"", //回帖ID "replyUrl":"", "replyAccountUrl":"", "replyDesc":"", //isPost=1时对应回帖内容;isPost=0时对应回帖回复内容 "postDesc":"", //主帖内容 "postUrl":"",//论坛帖子URL "replyAccountName":"", //回帖者用户名 "replyTime":"",//回帖时间 "replyerUrl":"", // 回帖url 当isPost=0,增加回帖消息字段 "replyerDesc": // 回帖内容 当isPost=0, 增加回帖消息字段 } ], "pageNo":1,//分页号 "pageSize":6,//每页记录数 "ret": 0, //状态码,0=正常,-1=异常或报错 "error-desc": “错误提示信息” //错误提示信息 } }}} ===== 6.1.4问答回复数 ===== {{{ 备注:问答回复消息数(接口无法出,改为通过读取接口:6.1.3问答回复列表,判断total值是否有改变,本地实现消息数提醒) }}} ===== 6.1.5问答回复列表 ===== {{{ 备注:问答回复列表(所有问题的回答列表) 接口开发:卢海潮 请求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 //注意此处pageno为小写(但接口端已做处理,可以不区分大小写) pagesize //注意此处pagesize为小写(但接口端已做处理,可以不区分大小写) 返回参数 { "pageNo":1, "pageSize":20, "total":20 "questions":[ { "id":461751, "title":"测试", "time":1404957613000 } ] } }}} ==== 6.4.1我的问答数量 ==== {{{ 备注:我的问答 接口开发:卢海潮 请求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"; 返回参数 { 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, //问题id "title":"妊娠期糖尿病的孕妇可以吃市面上的无糖食品吗?这些无糖食品是不是吃多少都不用担心血糖升高的呢?", "des": //问题详情 "time" //问题发布时间 "answers":[ { "id":431361, //答案id "authorFace":"http://img.pconline.com.cn/images/upload/upc/tx/kuaiwen/1308/22/c0/24751760_24751760_1377151997062_180x180.jpg", //回答用户头像 "adopted":1, //1=被采纳, 0=未被采纳 "time":"2014-01-16 16:36:32", "department":"营养科", "authorName":"潘丹峰", "answer":"无糖食品并非吃多少都没问题,市面上很多无糖食品只是不含单、双糖而已,有的无糖食品碳水化物含量也很高或含能量较高,同样也不利于血糖控制,所以选择这类食物还是要结合食物的成分、血糖指数来看。", "hospital":"广州市第一人民医院", "authorId":29743802 //回答者id } ] "ret": //0=成功,其他为失败 "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 //答案id questionid //问题id common_session_id 返回结果:JSON数据 { "result":0, // 0=成功,-1=异常 "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:收藏对象标识码 返回参数 { code: //收藏结果验证码 : 0:未收藏 ;1:已收藏 msg: //提示信息 “已收藏”、“未收藏” result: //状态码 1:正常返回 ; 0: 返回错误 } 结果示例: { "msg":"已收藏", "result":"1" } { "msg":"未收藏", "result":"1" } }}} ==== 6.5.2批量查询是否已收藏 ==== {{{ 备注:是否已收藏(该接口iOS没使用,符合Android V2.0版本需求) 接口开发:谢思华 请求URL:http://baike.pcbaby.com.cn/intf/app/2.0/favor_iscollect_batch_105.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 缓存方式:无 缓存时间:无 请求参数: 设置header Cookie = "common_session_id=xxxx" ids 数组类型;类型Id,收藏对象标识码(数字的Id) (英文逗号分隔) 格式如下:ids=1,10085&ids=8,10086 返回参数 {accountId:xxx, checks:[{objectType:1, objectId:10085, result:1}, {objectType:8, objectId:10086, result:-1}]} 其中: accountId:用户id objectType:对象类型Id:0文章;5帖子;1百科;6问答;7课程;8食谱 objectId:对象id result 1=已收藏,-1=未收藏 结果示例: 如果objectType不在查询范围内(0文章;5帖子;1百科;6问答;7课程;8食谱),或ids长度不够,则加msg提示,提示信息如下: { "accountId":2, "checks":[ { "objectId":"10085", "objectType":1, "result":-1 }, { "msg":"不存在该收藏类型,请检查objectType", "objectId":"10086", "objectType":2, objectType没有2的类型 "result":-1 }, { "objectId":"ddd", "objectType":8, "result":1 }, { "ids[3]":"d", "msg":"ids[3]长度不对,请检查ids[3]" } ] } }}} ==== 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为积分 (这里传22,获取积分) 返回参数:JSON { status, desc, userId, score } }}} ==== 6.9用户登录 ==== {{{ 备注:用户账号登录 接口开发: 请求URL: http://mrobot.pcbaby.com.cn/proxy/passport2/login HTTP请求方式:post 是否需要登录: 返回格式:JSON 请求参数: username //用户名 password //密码 auto_login //记住登陆状态的时间(天) captcha //验证码(手机用户密码错误大于等于100次需要输入验证码,验证码图片请求时会回设cookie:captcha,表单提交的时候带回cookie才能校验通过) 返回参数:JSON { status : 处理状态(0 为成功,其他为失败) message : 相关状态信息 session : common_session_id值 common_session_id : common_session_id值 userId: 当前登录用户id } }}} ==== 6.10获取用户信息 ==== {{{ 备注:获取用户信息 请求URL: http://mrobot.pcbaby.com.cn/v2/bbs/getUserInfo HTTP请求方式:get 是否需要登录:是 返回格式:json 请求参数: Cookie = "common_session_id = XXX” 返回参数: { "image":头像 "isVip":是否vip "name":用户名 "nickname":用户昵称 "common_session_id": "userId":用户ID } }}} ==== 6.11修改用户头像 ==== {{{ 备注:修改用户头像 请求URL: http://upc.pcbaby.com.cn/upload_head_url.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 请求参数: srcURL //头像url Cookie = "common_session_id = XXX”//用户id,放在headers里面请求 返回参数: 成功:{retCode: 0} 失败:{retCode: xxx} }}} ==== 6.12开放平台绑定或注册绑定 ==== {{{ 备注:开放平台绑定或注册绑定 请求URL: http://passport2.pcbaby.com.cn/passport2/api/register4open.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 请求参数: username :用户名 password :密码 type :开放平台APP应用的英文简称 email :邮箱地址 bind :绑定旧帐号或新注册帐号并绑定(值为空新注册帐号并绑定) notMobile :参数bind值为空,控制邮箱是否必填(值不为空邮箱必填) open_account_id :用户第三方帐号ID screen_name :第三方帐号昵称 return :返回地址(URL) token :授权信息(不为空则刷新授权信息,如果没有授权则添加授权信息) expires :授权信息(如果token参数不为空,尽量提供expires参数) reexpires_token :授权信息(如果token参数不为空,尽量提供reexpires_token 参数) reexpires :授权信息(如果token参数不为空,尽量提供reexpires参数) json :只要不为空,以json格式返回(优先级1) callback :支持回调函数(优先级2) 否则以windowname返回 auto_login: 设置Session的过期时间 (默认值15天) 返回参数: { "status":0,//处理状态(0 为成功,其他为失败) "desc":"OK", //处理状态(0 为成功,其他为失败) "accountId": //用户id "session":"",//common_session_id 登陆session信息的sessionId "returnUrl":""//返回地址 “field” : 定位到表单输入框(状态为失败时才出现) } 返回数据示例: {"status":-1,"desc":"类型为空"} {"status":-1,"desc":"APP配置错误"} {"status":-1,"desc":"域名错误"} {"status":-1,"desc":"获取第三方信息出错"} {"status":-1,"desc":"转换第三方数据出错"} {"status":-1,"desc":"获取第三方数据失败"} {"status":-4,"desc":"第三方帐号授权已失效"} {"status":2,"desc":"邮箱是必填项","field":"email"} {"status":2,"desc":"该邮箱已经注册过","field":"email"} {"status":2,"desc":"邮箱格式错误","field":"email"} {"status":-2,"desc":"未找到第三方账号开放ID,绑定失败!"} {"status":-1,"desc":"注册类型错误["+openConsumer.getId()+"]"} {"status":-3,"desc":"该第三方帐号已被绑定其他的通行证帐号"} {"status":-4,"desc":"该通行证已被绑定同个第三方平台的其他帐号"} {"status":-5,"desc":"密码是必填项","field":"password"} {"status":-6,"desc":"用户名或密码错误!","field":"password"} {"status":-6,"desc":"用户名或密码错误!","field":"password"} {"status":-7,"desc":"该帐号已被绑定"} {"status":-6,"desc":"用户名或密码错误!","field":"password"} }}} ==== 6.13第三方检查绑定关系、登录 (移动端专用) ==== {{{ 备注: 第三方检查绑定关系、登录 (移动端专用) 请求URL: http://passport2.pcbaby.com.cn/passport2/api/login_xauth.jsp HTTP请求方式:post 是否需要登录:是 返回格式:JSON 请求参数: type :开放平台APP应用的英文简称(type需在passport后台配置,但由于type的作用仅限于区分是QQ、微博、淘宝,需确认移动端有没有做相应的配置) open_account_id:开放平台帐号ID screenName :第三方帐号昵称,非必填 windowname: 1或true 以windowname形式返回,不传或0或false以json格式返回 callback: 支持回调函数,=windowname时表示以windowname形式返回 返回参数: {"status":-1,"desc":"类型错误"} {"status":-1,"desc":"缺失参数"} // 缺少open_account_id {"status":1,"desc":"未绑定"} { "status":0, "auth_token":"登录sessionId", "session":"登录sessionId", "account":"用户帐号ID", "cmu":"cmu", "用户名":"用户帐号ID", } }}} ==== 6.14 通行证配置 ==== {{{ 备注: 通行证配置(判断登录session是否已过期) 请求URL: http://passport2.pcbaby.com.cn/passport2/passport/session.jsp?resp_enc=UTF-8&req_enc=UTF-8 HTTP请求方式:post 是否需要登录:是 返回格式:JSON 请求参数: Cookie = "common_session_id = XXX”//用户id,放在headers里面请求 返回参数: { "passwordWrongCount": 0, "createAt"://创建时间, "accountName": "",//用户名 "accountId": //用户id "lastActiveAt": //最后活动时间 "lastIp": " //ip地址 "sessionId": "", "passType": 0,//绑定类型 "activated": true, "activatedMobile": false, "expiryAt": 1506231029650 } }}} === 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://www.pcbaby.com.cn/app/qzbd2/activity/?fromapp HTTP请求方式:get 是否需要登录:否 返回格式:HTMl页面 缓存方式:无 缓存时间:无 请求参数: 返回格式:HTMl页面 (说明:活动列表页为HTML,每一个活动的点击跳转链点格式如下pcbabybrowser://baby-webview/?url=http://baidu.com&title=每日签到 通过解析跳转链点中的URL和Title两个参数作为活动详情页的URL和状态栏标题) }}} === 9.0 亲子宝典一/二胎 资讯栏目 (mrobot) === {{{ 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": "高龄产妇" } ] } }}} ==== 9.0.1 资讯文章列表接口 (mrobot)==== {{{ URL:http://mrobot.pcbaby.com.cn/v2/cms/channels/1?type=qzbd1tai&pageSize=20&pageNo=1 作用:获取资讯栏目 提交方式:GET 参数: /channels/1:栏目id ;(qzbd1tai:1 头条;2 怀孕;3 产后;4 育儿 ;qzbd2tai:1 头条;2 备孕;3 孕育;4 高龄产妇 ) type:(qzbd1tai:亲子宝典一胎,qzbd2tai:亲子宝典二胎); pageSize:每页显示的条数; pageNo:当前所在页数。 返回结果:JSON { "articleList": [ { "id": "3473048", "image": "http://img0.pcauto.com.cn/pcauto/1311/25/g_3473048_1385345794838_240x160.jpg", "pubDate": "2013-11-25", "title": "标题", "type": 1, "url": "http://www.pcauto.com.cn/nation/347/3473048.html" }, { "id": "3473181", "image": "http://img0.pcauto.com.cn/pcauto/1311/25/g_3473181_1385343847663_240x160.jpg", "pubDate": "2013-11-25", "title": "标题", "type": 1, "url": "http://www.pcauto.com.cn/nation/347/3473181.html" } ], "focus": [ //焦点图数据,当channels=1时才返回 { "id": "3469260", "image": "http://img0.pcauto.com.cn/pcauto/guangzhou/2013/jsjx/1311/11243.jpg", "pubDate": "2013-11-25", "title": "标题", "topicUrl": "http://www.pcauto.com.cn/guangzhou/346/3469260.html", "url": "http://www.pcauto.com.cn/guangzhou/346/3469260.html" } ], "pageNo": 1, "pageSize": 20, "topArticle": [ //热点文章,V2.0没有用到 { "id": "4245514", "image": "http://img0.pcauto.com.cn/pcauto/1311/25/3463325_chezhan.jpg", "pubDate": "2013-11-25", "seq": 4, "title": "标题", "to-uri": "pcautobrowser://bbs-topic/4245514", "type": 2 } ], "topFocus": [ //焦点图广告数据,V2.0没有用到 { "cc-uri": "", "image": "http://imgad0.pcauto.com.cn/ivy/image/201311/7/13837866234700.jpg", "seq": 3, "title": "广告", "to-uri": "http://ivy.pcauto.com.cn/adpuba/click?adid=291573&id=auto.khd.zx.syjdt.", "vc-uri": "http://ivy.pcauto.com.cn/adpuba/show?adid=291573&id=auto.khd.zx.syjdt.&media=js" } ], "pageNo": 1, "pageSize": 20, "total": 150 } }}} ==== 9.0.2.资讯文章终端接口 (mrobot)==== {{{ URL:http://mrobot.pcbaby.com.cn/v3/cms/articles/2097770?pageNo=1&size=17&picRule=2 作用:获取文章内容 提交方式:GET 参数: 2097770? 文章id; pageNo:当前所在页数; picRule:图片默认显示规则,0为显示小图,1为显示文字链接;2为显示大图。 size:默认文章字体大小; 返回结果:HTML页面 同时在html源代码中加入以下内容,此为附加信息 url:用于获取评论的url title:文章的标题 firstPic:用于分享,文章终端的第一张图(有图返回图片,无图则不用返回该字段) wap_url: 用于分享,分享出去后的点击url }}} === 10.百科列表接口 === {{{ URL:http://baike.pcbaby.com.cn/intf/app/content_wiki_312.jsp?REQUEST_CODE=312     作用:获取亲子百科所有的分类、专区和知识点 提交方式:GET 参数: “REQUEST_CODE” : 312[请求代码] 返回结果:JSON { "RESPONSE_CODE": //int返回代码, 与请求代码一致 "RESPONSE_STATUS”: //int返回状态,参考第三章.返回状态参数对照表 ”RESPONSE_INFO""{ "updateTime": //时间戳此接口更新时间 "wikiSortCount": //int一级分类数量 "wikiSortList”[ { "wikiSortName": //string,一级分类名 "isHaveSecondSort": //bool,是否有二级分类 "wikiSortUrl": //string,一级分类页对应url,如果isHaveSecondSort为false必须提供 "wikiSecondSortCount": //int,二级分类数量,如果isHaveSecondSort为true必须提供 "wikiSecondSortList":[ { "wikiSecondSortName": //string,二级分类名 "isHaveThirdSort”: //bool,是否有三级分类 "wikiSecondSortUrl”: //string,二级分类页对应url, "wikiThirdSortCount”: //int,三级分类数量如果isHaveThirdSort为true必须提供 "wikiThirdSortList”: [ { "wikiThirdSortName": //string,三级分类名 "isHaveFourthSort": //bool,是否有四级分类 "wikiThirdSortUrl”: //string,三级分类页对应url "wikiFourthSortCount": //int,四级级分类数量如果isHaveFourthSort为true必须提供 "wikiFourthSortList": [ { "wikiFourthSortCmtUrl": //string,评论链接 "wikiFourthSortName": //sting,四级分类名(文章名) "wikiFourthSortUrl": //string,四级分类链接(文章链接) } …… ] } …… ] } …… ] }…… ] } } }}} ==== 10.1百科是否有更新 ==== {{{ URL:http://baike.pcbaby.com.cn/intf/app/content_wiki_update_309.jsp 作用:百科是否有更新 提交方式:GET 参数:“REQUEST_CODE” : 309 [请求代码] 返回结果:JSON “RESPONSE_CODE” : [int 返回代码,与请求代码一致] “RESPONSE_STATUS”: [int返回状态,参考第三章.返回状态参数对照表]] ”RESPONSE_INFO” { “updateTime”:[时间戳 此接口更新时间] }    }}} ==== 10.2百科搜索 ==== {{{ URL:http://baike.pcbaby.com.cn/intf/app/content_wiki_search_310.jsp 作用:百科搜索 ps:因为此接口搜索内容为接口15的第四级内容,iOS和android端均使用本地搜索代替,此接口暂时无用 提交方式:GET { “REQUEST_CODE” : 310 [请求代码] “keywords”:[string 搜索的关键字] } 参数: 返回结果:JSON “RESPONSE_CODE” : [int 返回代码,与请求代码一致] “RESPONSE_STATUS”: [int返回状态,参考第三章.返回状态参数对照表]] ”RESPONSE_INFO” { “wikiThirdSortList”: [{ “wikiThirdSortName”:[string 三级分类名] “wikiThirdSortUrl”:[string 三级分类页对应url] }] } }}} === 11.0二胎政策接口 === {{{ URL:http://banshi.pcbaby.com.cn/intf/app/policy.jsp 作用:查询该地区二胎政策实施情况 提交方式:GET 参数: areaId:地区id 返回结果:JSON { "result":0,(0未实施,1已实施) "detail-text":"广东省广州市天河区五山街道华工社区于2014年01月14日开始实施单独二胎政策", "text":"广东省广州市于2014年01月14日开始实施单独二胎政策", "articleList":[ { "id": "3473181", "title": "官方公告", "type": 1, "uri": "http://www.pcauto.com.cn/nation/347/3473181.html" }, { "id": "3473181", "title": "精彩推荐", "type": 2, "uri": "pcbabybrowser://information-channel/${channelid}?channelName=精彩推荐" }, { "id": "3473181", "title": "热门话题", "type": 3, "uri": "pcbabybrowser://topics-list/${channelid}?channelName=热门话题" } ] } title和type固定, 精彩推荐,热门话题的uri根据文章栏目和帖子栏目改相应的id }}} ==== 11.1 官方公告 ==== {{{ URL:http://banshi.pcbaby.com.cn/intf/app/policydetail.jsp 作用:查询官方公告内容 提交方式:GET 参数: id:地区id 返回结果:HTML页面 }}} ==== 11.2 地址查询接口 ==== {{{ URL:http://banshi.pcbaby.com.cn/intf/app/area.jsp 作用:查询地址信息,先精确到区,如果有镇和街道的数据,则以此类推 提交方式:GET lastid:最新的id 参数: 返回结果:JSON 如果有更新,update为1,否则为0 { "lastid":123125, "update":1, "nodes":[ "id":1, "name":"广东", "nodes":[ "id":1, "name":"广州", "nodes":[ "id":1, "name":"天河" ] ] ] } { "last":123125, "update":0 } ps:先精确到区,如果有镇和街道的数据,则以此类推。 }}} ==== 11.3.热门话题列表 (mrobot)==== {{{ URL:http://mrobot.pcbaby.com.cn/v2/bbs/forums/2190?pageSize=20&pageNo=1 作用:获取亲子网帖子列表 提交方式:GET 参数: /forums/2190?:论坛版块id; pageNo:页数,不需要pageSize,具体每页显示的条数由论坛后面配置,目前是每页显示50条; pageSize=20 //每页条数 返回结果:json数据 { "forum": { //该部分数据app没用到 "bbs": 2190, "forumId": 2190, "name": "二胎时代", "parentId": 1 }, "pageNo": 1,//当前页数 "pageSize": 20,//每页条数 "topTopics": [],//该部分数据app没用到 "topicList": [ { "author": {//该部分数据app没用到 "name": "qz32670168", "nickname": "婷婷", "userId": 32670168 }, "createAt": 1421050254526,//发帖时间 "floor": 1, //该部分数据app没用到 "image": "",//该部分数据app没用到 "lastPoster": {//该部分数据app没用到 "name": "qz32670168", "nickname": "婷婷", "userId": 32670168 }, "message": "晚上孩子老是蹬被子,你们家的宝宝还用包被裹着吗?大概裹到什么时候哈?",//该部分数据app没用到 "replyCount": 0,//楼层数 "title": "宝妈们,你们给孩子裹包被了吗",//标题 "topicId": 2156590,//帖子id "uri": "http://bbs.pcbaby.com.cn/topic-2156590.html",//该部分数据app没用到 "view": 2//浏览数 } ], "total": 1359 } }}} ==== 11.4 热门话题终端页帖子接口 (mrobot)==== {{{ 同4.3 帖子终端接口 }}} ==== 11.5 办证单位查询接口 ==== {{{ URL:http://banshi.pcbaby.com.cn/intf/app/office.jsp 作用:查询办证单位,街道和社区合并显示 提交方式:GET 参数: areaId:地区id 备注:街道和社区合并显示 返回结果:JSON { "city": [ //市级 { "address": "广州市府前路1号市政府大院", "id": 4420, "name": "广州市人口和计划生育局", "phone": "", "tel": "020-83330656", "type": 11 } ], "community": [ //社区 { "address": "", "id": 18073, "name": "洋田村委会", "phone": "13602279720", "tel": "020-32971698", "type": 2 } ], "district": [ //区级 { "address": "广州市黄埔区大沙东路333号", "id": 19324, "name": "黄埔区人口和计划生育局", "phone": "", "tel": "020-82378563", "type": 21 } ], "street": [ //街道 { "address": "广州市萝岗区九龙镇九佛中路978号", "id": 687, "name": "九龙镇计生办", "phone": "", "tel": "020-87487233", "type": 1 } ] } }}} ==== 11.6 办事单位地点添加接口 ==== {{{ URL:http://banshi.pcbaby.com.cn/intf/app/feedbackoffice.jsp 作用:办证单位或其他信息反馈接口 提交方式:POST 参数: accountId:用户id(如果已登录) type:类型:1=新增,2=修改 units:一个json格式的字符串,内容如下: [ { "id": 1231,//新增则无id "areaId": 123, "address": "asdfasd", "name": "asdfasd", "tel": "020-12345678" } ] 返回结果:JSON { “uri”:路径,接口URI路径 “result”:1,(0失败,1成功) "msg":"提交成功" } }}} ==== 11.7 单独二胎政策实施时间添加接口 ==== {{{ URL:http://banshi.pcbaby.com.cn/intf/app/feedbackpolicy.jsp 作用:二胎政策反馈接口 提交方式:POST 参数: accountId:用户id areaId: 地区id type: 类型: 1=时间错误, 2=已经开始实施 date: 实施时间,“2014-02-09”,格式 yyyy-MM-dd content: 反馈内容 link: 参考链接 { “result”:1, //返回结果,0=失败,1=成功 "msg":"提交成功" //提示信息 } }}} ==== 11.8 办事指南接口 ==== {{{ URL:http://banshi.pcbaby.com.cn/intf/app/process.jsp 作用:获取办事指南信息接口 提交方式:GET 参数: areaId:省份id 返回结果:HTML页面 点击步骤跳转协议:pcbabybrowser://procedure-detail/${id}?count=4&num=1&areaId=${areaId} 点击文章跳转协议:pcbabybrowser://information-article/1276412 点击帖子跳转协议:pcbabybrowser://bbs-topic/4337761 }}} ==== 11.9 办事指南详细解释接口 ==== {{{ URL:http://banshi.pcbaby.com.cn/intf/app/processitem.jsp?processId=241&count=2&num=2&areaId=3 作用:办事具体流程接口 提交方式:GET 参数: processId=241 count=2 //步骤总数 num=2 //当前步骤数 areaId=3 //地区id 返回结果:HTML页面 点击纠错跳转协议:pcbabybrowser://correction/${id} 点击办证材料:pcbabybrowser://baby-webview/?url=http://xxxx 点击查看配偶办事单位:pcbabybrowser://baby-search-unit/ 点击电话:pcaction://baby-tel/?tel=${tel} 点击地址:pcaction://baby-map/?address=${address} 用于纠错功能的显示,需要在里面加入json /*@_HTML_META_START_ { "units": [ { "areaId":"3",//地区id "id":"31", //id "name":"北京相关部门",//部门 "address":"北京市天高皇帝远", //地址 "tel":"010 110",//电话 "pro":"北京市",//省份 "city":"北京市",//城市 "region":"朝阳区"//区 } ] } _HTML_META_END_@*/ }}} ==== 11.10 办证材料详细解释接口 ==== {{{ URL:http://banshi.pcbaby.com.cn/intf/app/material/${materialId}.html 备注:在接口11.9对应的html页面中,点击办证材料区域,由约定协议:pcbabybrowser://baby-webview/?url=http://banshi.pcbaby.com.cn/intf/app/material/81.html&title=计划生育服务证,获取对应的url和title(该页面的标题) 提交方式:GET 参数: materialId: title: 返回结果:HTML页面 页面中,使用html注释以下格式json,用于纠错功能 /*@_HTML_META_START_ { "units": [ { "id": 1231, "areaId": 123, "address": "asdfasd", "tel": "020-12345678", "pro": "xx省", "city": "xx市", "region": "xx区" }, { "id": 1231, "areaId": 123, "address": "asdfasd", "tel": "020-12345678", "pro": "xx省", "city": "xx市", "region": "xx区" } ] } _HTML_META_END_@*/ }}} ==== 11.11 办事指南纠错接口 ==== {{{ 暂时与接口 11.6 办事单位地点添加接口,相同 }}} === 12.0 应用推荐 === {{{ 备注:获取应用推荐页面 请求URL: iOS请求url: http://www.pcbaby.com.cn/app/recommend/2tai_iphone/ Android请求url : http://www.pcbaby.com.cn/app/recommend/2tai_android/ 提交方式:GET 参数: 返回结果:HTML页面 }}} === 13.0 获取最新楼层数和文章评论id (mrobot)=== {{{ URL:http://mrobot.pcbaby.com.cn/v3/cmt/get_newest_floor 作用:获取文章评论数据 提交方式:GET 参数: url:文章url 返回结果:JSON { "total": 9, //未使用参数 "id": 13156992, //文章ID "floor": 11, //评论数 "turl": "http://huaiyun.pcbaby.com.cn/203/2034867.html", //文章URL "url43g": "http://cmt.pcbaby.com.cn/topic/3g/a0/r0/t13156992.html", //WAP评论URL "url": "http://cmt.pcbaby.com.cn/topic/a0/r0/p1/ps30/t13156992.html" //评论URL } }}} ==== 13.1 资讯文章评论接口 (mrobot) ==== {{{ URL:http://mrobot.pcbaby.com.cn/v3/cmt/new_topics/12958224?articleId=1147610&reverse=0&pageNo=1&pageSize=20 作用:获取文章评论数据 提交方式:GET 参数: /new_topics/12958224:文章评论id;(从接口13.0获得) articleId:文章id; pageSize:每页显示的条数; pageNo:当前所在页数; reverse:评论显示方式,0为倒序,即从最新的评论开始显示;1为正序,即从最旧的评论开始显示。 返回结果:JSON { "comments": [ { //没有引用其他评论的评论 "1": { //表达其引用关系的key "id":"24991904",//帖子id "name": "不是网易的江苏省盐城市网友 帅气飞扬: ", //用户名称 "floor": "1737", //楼层 "time": "2013-01-05 09:05:40", //时间 "content": "内容过于暴力,已和谐" //内容 }, "current":"1", //当前最外层引用标识 "support":"10086" //"顶"数量 "expand":false //判断是否展开,默认为false }, { "3": { "id":"24991804",//帖子id "name": "不是网易的江苏省盐城市网友 帅气飞扬: ", "floor": "1737", "time": "2013-01-05 09:05:40", "content": "内容过于暴力,已和谐" }, "2": { "id":"24941904",//帖子id "name": "不是网易的江苏省盐城市网友 帅气飞扬: ", "floor": "1737", "time": "2013-01-05 09:05:40", "content": "内容过于暴力,已和谐" }, "1": { "id":"24491904",//帖子id "name": "不是网易的江苏省盐城市网友 帅气飞扬: ", "floor": "1737", "time": "2013-01-05 09:05:40", "content": "内容过于暴力,已和谐" }, "4": { "id":"24993904",//帖子id "name": "不是网易的江苏省盐城市网友 帅气飞扬: ", "floor": "1737", "time": "2013-01-05 09:05:40", "content": "内容过于暴力,已和谐" }, "current":"4", "support":"10086" //顶数 "expand":false //判断是否展开,默认为false } ], "hot-comments": [ { //没有引用其他评论的评论 "1": { //表达其引用关系的key "id":"24691904",//帖子id "name": "不是网易的江苏省盐城市网友 帅气飞扬: ", //用户名称 "floor": "1737", //楼层 "time": "2013-01-05 09:05:40", //时间 "content": "内容过于暴力,已和谐" //内容 }, "current":"1" "support":"10086" //顶数 "expand":false //判断是否展开,默认为false } ] } }}} ==== 13.2 顶评论 ==== {{{ 备注:顶评论 请求URL: http://cmt.pcbaby.com.cn/action/comment/support_json.jsp HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数: cid:评论ID sp=1(顶数量+1) (说明:“common_session_id=F7944998D4C5E2F849C085976791BE51FA2F3CE3A5F6D159”是用户登录后得到的身份ID。大部分需要以登录身份操作的接口都需要将该值作为请求HTTP头中的Cookie值传入) 返回参数: { "support": 1, //顶数量 "floor": 11, //楼层数 "status": 0, //状态码 "topicId": 12865954, //文章ID "postId": 25820214 //评论ID } }}} ==== 13.3 回复文章评论 ==== {{{ 作用:回复文章评论 URL:http://cmt.pcbaby.com.cn/action/comment/create_utf8.jsp 提交方式:post 请求参数: id //评论ID url //文章URL title //文章标题 username //用户名(用户可选择登录评论或匿名评论,登录评论时,此处为用户昵称;匿名评论时,此处为太平洋网友) anonymous // 是否匿名(1为匿名评论,0为非匿名) columnId=0 //默认为0 content //评论内容 client=3 //3为iPhone用户 replyFloor2 //(可选参数,回复某一楼层,该数字为回复的楼层数。不传则为回复文章。) (说明:非匿名评论时需要将common_session_id作为请求HTTP头中的Cookie值传入 “common_session_id=F7944998D4C5E2F849C085976791BE51FA2F3CE3A5F6D159”是用户登录后得到的身份ID。大部分需要以登录身份操作的接口都需要将该值作为请求HTTP头中的Cookie值传入) 返回参数: { "commentId": 27355686, //评论ID "floor": 14, //楼层数 "showName": "呆滞的狐狸", "brief": "", "status": 2, "createTime": "2015-01-12 16:50:54", "resultCode": 1, "resultMsg": "您的评论已经成功发表。谢谢!", "userId": 32870370 //用户ID } }}}