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