一.基本约定
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源代码中加入以下内容,此为附加信息
<!--
/*@_HTML_META_START_
{
"title": "春节保证让宝宝不生病的辅食调理大法",
"url": "http://product.pcbaby.com.cn/zx/jdzx/1501/2097770.html",
"wap_url": "http://m.pcbaby.com.cn/x/209/2097770.html",
"firstPic": "http://img0.pcbaby.com.cn/pcbaby/1502/04/2097770_02150204.jpg",
}
_HTML_META_END_@*/
-->
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": "<img src=http://www.pconline.com.cn/images/comment/face201.gif>",
"status": 2,
"createTime": "2015-01-12 16:50:54",
"resultCode": 1,
"resultMsg": "您的评论已经成功发表。谢谢!",
"userId": 32870370 //用户ID
}