一.基本约定
1.开发机、测试机代理地址:
mrobot开发机代理:192.168.10.199 端口:1080
mrobot测试机代理:192.168.10.198 端口:1080
2.当接口处理正常时,HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。
3.当接口处理异常时,HTTP STATUS CODE 返回非200,并且给出具体的错误信息。
{
"desc":"给用户的提示放在这里"
}
4.接口默认的字符编码是UTF-8,接口需要实现对req-enc和resp-enc参数的支持。
5.所有有写操作的数据接口,必须用POST方式提交,在接口里需要判断提交方式,拒绝GET的调用请求。
6.接口中的JSON字符串,key都用双引号("")包裹,value是字符串类型时,也用双引号("")包裹;是数字类型时,不用引号
7.需要分页的接口,统一返回以下字段: pageNo,pageSize,total
8.涉及接口都增加请求参数:v = 220 //版本号(数字)
9.发帖,回帖中status字段值的含义如下:
STATUS_ERROR = -1; //错误
STATUS_SUCCESS = 0; //成功
STATUS_NO_RIGHT = 1; //没有权限
STATUS_PARAM_WRONG = 2; //参数错误
STATUS_CONTENT_OVERFLOW = 3; //内容超出长度
STATUS_EXISTS = 4; //数据已经存在
STATUS_NOT_FOUND = 5; //数据查找不到
STATUS_NO_LOGIN = 6; //没有登录
STATUS_USER_LOCK = 7; //用户被锁
当status不等于0时,具体原因参照message字段的说明。
二.接口列表
1.0 个人中心
1.1 问答回复数
备注:获取新的未读问答回复数(接口已完成,使用请连开发机代理)
(参考接口:http://trac.pc.com.cn/kuaiwen_baby/ticket/54)
接口开发:吴全贵,陈子洋
mrobot接口url:http://mrobot.pcbaby.com.cn/s/qzbd/kuaiwen/myQuestionReplyNums.xsp(已放在192.168.75.40开发机)
后端url:http://kuaiwen.pcbaby.com.cn/intf/app/my_question_reply_nums.jsp(已在线上)
HTTP请求方式:get
是否需要登录:否
返回格式:JSON
是否有缓存:无
缓存时间:
请求参数:
设置header Cookie = "common_session_id=xxxx";
v = 220 //版本号
返回参数
{
"ret": 0, //返回状态,0=成功,非0=失败
"questionsCount": 10, //问答回复数
"desc": "提示信息" //错误提示信息
}
1.2 我的问答数量
备注:个人中心-我的问答,获取已解决和未解决数量(接口已完成,使用请连开发机代理)
接口开发:卢海潮,陈子洋
mrobot请求URL:http://mrobot.pcbaby.com.cn/s/qzbd/kuaiwen/myQuestionNums.xsp(已放在192.168.75.40开发机)
后端请求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";
v = 220 //版本号
返回参数
{
solvedCount:已解决数量
unsolvedCount:未解决数量
}
===华丽分割线===(备注:接口1.3-1.6的后端接口已有,mrobot做中转)
1.3 是否已收藏
备注:判断是否已收藏(接口已完成,使用请连开发机代理)
接口开发:吴全贵、卢海潮,陈子洋
mrobot请求URL:http://mrobot.pcbaby.com.cn/s/qzbd/bbs/checkCollected.xsp?type=1&id=10000(已放在192.168.75.40开发机)
后端接口Url:http://my.pcbaby.com.cn/collection/intf/collection/app/check_collected.jsp (已在线上)
HTTP请求方式:get
是否需要登录:是
返回格式:JSON
缓存方式:无
缓存时间:无
请求参数:
common_session_id:需通行证登录,设置用户COOKIE
type:收藏对象类型(0文章;5帖子;1百科;6问答;7课程;8食谱)
id: 收藏对象标识码,即收藏对象ID
返回参数
{
"result":1, //状态码,1=正常返回,0=返回错误
"code":1, //收藏结果验证码,1=已收藏,0=未收藏
"msg":"取消收藏成功" //提示信息
}
1.4 批量查询是否已收藏
备注:批量查询是否已收藏(接口已完成,使用请连开发机代理)
接口开发:吴全贵、卢海潮,陈子洋
mrobot请求URL:http://mrobot.pcbaby.com.cn/s/qzbd/bbs/checkCollectedBatch.xsp?ids=1,10085&ids=8,10086&ids=6,10087(已放在192.168.75.40开发机)
后端请求URL:http://my.pcbaby.com.cn/collection/intf/collection/app/iscollect_batch.jsp
HTTP请求方式:get
是否需要登录:是
返回格式:JSON
缓存方式:无
缓存时间:无
请求参数:
common_session_id:需通行证登录,设置用户COOKIE
ids //查询id字符串。
格式:ids=类型Id,查询文章id(中间用英文逗号分隔)&ids=类型Id,查询文章id(中间用英文逗号分隔)
例如:ids=1,10085&ids=8,10086& ids=6,10087
返回参数
{ "accountId":20848253, //用户ID
"checks": "[{
\"objectId\":10085, //收藏对象Id
\"objectType\":1, //收藏类型,(0文章;5帖子;1百科;6问答;7课程;8食谱)
\"result\":-1 //查询结果,1=已收藏,-1=未收藏
}]"
}
1.5 删除收藏
备注:删除收藏
接口开发:吴全贵、卢海潮
请求URL:http://my.pcbaby.com.cn/collection/intf/collection/app/uncollect.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:JSON
请求参数:
type:收藏对象类型(0文章;5帖子;1百科;6问答;7课程;8食谱)
common_session_id:登录用户id
id: 收藏对象标识码,即收藏对象ID
返回参数:
{
“msg”:”取消收藏成功”, //提示信息
“result”:1 //1=取消收藏成功,0=该文章不存在或已取消收藏
}
1.6 添加收藏
备注:添加收藏
接口开发:吴全贵、谢思华
请求URL:http://my.pcbaby.com.cn/collection/intf/collection/app/collect.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:JSON
请求参数:
common_session_id:需通行证登录,设置用户COOKIE
type:收藏对象类型(0文章;5帖子;1百科;6问答;7课程;8食谱)
id: 收藏对象标识码,即收藏对象ID
title:文章标题,收藏频道和工具时才需要传此参数
返回参数:JSON
{
"msg": "收藏成功", //提示信息
"result":1, // 1=收藏成功,0=收藏失败
}
2.0 崔玉涛视频
2.1 崔玉涛专栏首页
备注:崔玉涛专栏首页接口(v2.2开始崔玉涛视频列表增加播放次数字段),(接口已完成,使用请连开发机代理)
mrobot接口url:http://mrobot.pcbaby.com.cn/v2/qzbd/cytHome
后端接口url:
http://www.pcbaby.com.cn/app/qzbd2/cyt/
http://ivy.pconline.com.cn/adpuba/show?id=pc.khd.zx.btxfldxj.&media=js
HTTP请求方式:get
是否需要登录:否
返回格式:JSON
是否有缓存:有
缓存时间:15分钟
请求参数:
v = 220 //版本号
返回参数:
{
"status": 0, //状态码 0正常返回 非0请求错误
"desc": "", //提示信息 status=0提示信息为空;status非0,给出对应的出错提示信息
"authorInformation" : //专家信息
{
"face" : "" //专家头像
"name" : "" // 专家姓名
"title" : "" //职称
"position" : "" //职务
"introduction" : "" //专家介绍
},
"ads": //广告
[
{
"image": "" //广告图片
"toUri" : "" //跳转uri
}
],
"hot": //育儿热点
{
"title":"育儿热点",
"section":[
{
"categoryId": //分类id
"title": //分类标题
"image": //图片
}
...
]
},
"video": //在线视频
{
"title":"在线视频",
"section":[
{
"articleId": "1987318",
"date": "2014-12-11",
"image": "http://img0.pcbaby.com.cn/pcbaby/zhuanjia/jtye/shipin/1412/yekebuting.jpg",
"title": "亲子课堂:孩子夜咳不停怎么回事?",
"playCount":"10" //视频播放次数,新增字段
}
...
]
},
"question": //问答专栏
{
"title":"问答专栏",
"section":[
{
"articleId": "2042246",
"num": "3",//专栏期数id
"date": "2015-01-06",
"expertId": "29003920",
"image": "http://www1.pcbaby.com.cn/03daodu.jpg",
"title": "孩子经常发烧怎么办?"
}
...
]
},
"article": //育儿文章
{
"title":"育儿文章",
"section":[
{
"articleId": "2048505",
"date": "2015-01-06",
"image": "http://img0.pcbaby.com.cn/pcbaby/1501/06/g_2048505_1420534505891.jpg",
"preview": "育儿路上烦恼多,怎么才能护理好孩子的日常起居?怎么可以培养孩子的各项能力?遇到了这些问题就赶紧来提问吧!除了能得到专家的答疑,还有机会赢得崔玉涛医生的育儿书籍一本哦。",
"title": "【提问有礼】赢崔玉涛育儿书"
}
...
]
}
}
2.2视频列表
备注:视频列表(v2.2开始崔玉涛视频列表增加播放次数字段),(接口已完成,使用请连开发机代理)
mrobot接口url:http://mrobot.pcbaby.com.cn/v2/qzbd/cytList?type=video&pageNo=1&pageSize=20
后端接口url:http://www.pcbaby.com.cn/app/qzbd2/cyt/video/
HTTP请求方式:get
是否需要登录:否
返回格式:JSON
是否有缓存:有
缓存时间:15分钟
请求参数:
pageNo //第几页
pageSize //每页显示多少条
type //类型,此次type=video
v = 220 //版本号
返回参数:
{
"data": [
{
"articleId": "1987318",
"date": "2014-12-11",
"image": "http://img0.pcbaby.com.cn/pcbaby/zhuanjia/jtye/shipin/1412/yekebuting.jpg",
"title": "亲子课堂:孩子夜咳不停怎么回事?",
"playCount":"10" //视频播放次数,新增字段
}
],
"pageCount": 1,
"pageNo": 1,
"pageSize": 20,
"total": 1
}
2.3统计视频播放次数
备注:统计单个视频播放次数
接口url:http://v.pcbaby.com.cn/__counter.jsp
HTTP请求方式:post
是否需要登录:否
返回格式:JSON
是否有缓存:无
缓存时间:无
请求参数:
video //视频id
v = 220 //版本号
返回参数:附:返回200状态码表示成功,其他表示失败
3.0 交流圈
3.1 私密圈
3.1.1 私语、话题列表
备注:获取私密圈私语、话题列表(接口已完成,使用请连开发机代理)
(参考接口:http://trac.pc.com.cn/iphone/wiki/baby/interface#a4.7私密圈帖子列表-私语)
说明:1、去除app没用到字段;2、新增字段:recommend(是否推广位数据),recommendType(列表推广类型),tagName(专场标签),guestName(特邀嘉宾标签)
接口开发:丁健勇,陈子洋
mrobot接口URL:http://mrobot.pcbaby.com.cn/s/qzbd/bbs/getSecretTopics.xsp
后端接口URL:http://bbs.pcbaby.com.cn/mobile/v2_2/getSecretTopics.do
HTTP请求方式:get
是否需要登录:否
返回格式:JSON
缓存方式:无
缓存时间:无
请求参数:
type=1;1=私语,2=话题,必须参数
pageNo=1;页码
pageSize=10;每页条数
maxLength=240;内容最大长度
agent=2;2=亲子宝典IOS端,3=亲子宝典Android端
v = 220 //版本号
返回参数,成功:
{
pageNo: 1, //页码
pageSize: 20, //每页条数
total: 15163, //总数量
topics: [
{
topicId: 2156386, //帖子ID
title: "最难忘前任的那点", //标题
message: "最难忘前任的那点", //帖子内容(当recommend=1且recommendType=3时,这里为“引导话题贴内容”)
createAt: "2015-01-12 14:34:15", //发帖时间
viewCount: 2, //帖子浏览数
replyCount: 0, //帖子回复数
recommend: 0, //是否推广位数据:0=否;1=是
recommendType: 1, //私语列表推广类型:1=话题贴通显推广;2=私密贴推广;3= 话题引导贴推广(当接口数据为话题列表数据时,该字段为0)
tagName: "杜蕾斯专场", //专场标签(string类型,字段为空时表示无标签)
guestName: "毒舌辣妈", //特邀嘉宾标签 (string类型,字段为空时表示无标签)
}
]
}
3.1.2 闺蜜列表
备注:获取私密圈-闺蜜列表(接口已完成,使用请连开发机代理)
(参考接口:http://trac.pc.com.cn/iphone/wiki/baby/interface#a4.9私密圈闺蜜帖子列表)
说明:1、去除app没用到的字段;2、新增字段:replyAuthorFace(闺蜜达人的头像)
接口开发:丁健勇,陈子洋
mrobot接口URL:http://mrobot.pcbaby.com.cn/s/qzbd/bbs/getBestieTopics.xsp
后端接口URL:http://bbs.pcbaby.com.cn/mobile/v2_2/getBestieTopics.do
HTTP请求方式:get
是否需要登录:否
返回格式:JSON
缓存方式:无
缓存时间:无
请求参数:
fid=2270;版块ID,闺蜜列表可不传该参数,默认2270
pageNo=1;页码
pageSize=10;每页条数
agent=2;2=亲子宝典IOS端,3=亲子宝典Android端
v = 220 //版本号
返回参数,成功:
{
pageNo: 1, //页码
pageSize: 20, //每页条数
total: 15163, //总数量
topics: [
{
replyAuthorId: 29503245, //回帖用户ID
replyAuthorFace:"http://i1.3conline.com/images/upload/upc/face/29/50/32/45/29503245_150x150",
replyAuthorName: "毒舌辣妈", //显示闺蜜达人在个人中心的昵称
replyContent: "我觉得大部分女人都会比较希望老公终身不娶的女儿!", //回帖内容
replyTime: 1420790175000, //回帖时间
source: 0, //列表来源 0=私语,1=话题
title: "常常会想一个问题就是如果我不幸离世了,我的老公...", //主贴标题
message: "常常会想一个问题就是如果我不幸离世了,我的老公...", //主贴内容
topicId: 2151480, //帖子ID
}
]
}
3.2 生活圈
3.2.1 潮妈、圈子-精华列表
备注:生活圈潮妈列表,圈子-精华列表,时间倒序(接口已完成,使用请连开发机代理)
(参考接口:http://trac.pc.com.cn/iphone/wiki/baby/interface#a4.1生活圈精华帖子列表 ,更改返回图片尺寸)
说明:1、去除app没用到的字段
接口开发:丁健勇,陈子洋
mrobot接口URL:http://mrobot.pcbaby.com.cn/s/qzbd/bbs/getPicks.xsp?forums=1917,2130,1828,1799,1820,2140,1771,1776,2200&noForums=1929&pickType=pick3&showImage=true&ie=utf-8
后端接口URL:http://bbs.pcbaby.com.cn/intf/forum/getPicks.do
HTTP请求方式:get
是否需要登录:否
返回格式:JSON
缓存方式:无
缓存时间:无
请求参数:
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)
maxLength:帖子内容需要截取的长度,默认240个字节
showImage=true;显示图片
ie=utf-8;输出内容的编码格式
cacheTime=1200;缓存时间,单位为秒
pageNo:1 //页码
pageSize:10 //每页条数
agent=2;2=亲子宝典IOS端,3=亲子宝典Android端
v = 220 //版本号
requestScr=wap //新增参数(控制返回图片格式大小)
返回参数:
{
desc: "查询成功", //状态描述
pageNo: 1, //页码
pageSize: 20, //每页条数
status: 0, //状态码
topics: [
{
createAt: "2015-01-11 19:30:35", //帖子的创建时间
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"
],
title: "超可爱萌妹子融化人心", //帖子标题
message: " 《雯雯 萌萌哒》超级可爱的萌妹子,完全可以萌化到心底里...", //帖子内容
topicId: 2155848, //帖子id
userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/12/65/76/7/1265767_70x70", //用户头像
userId: 1265767, //用户ID
userName: "啃蘋果的壞蛋", //用户昵称
views: 22, //帖子浏览数
replyCount: 2, //帖子回复数
}
],
total: 515 //总帖子数
}
3.2.2 圈子列表
备注:生活圈圈子列表(接口已完成,使用请连开发机代理)
(参考接口:http://trac.pc.com.cn/iphone/wiki/baby/interface#a4.2生活圈栏目列表)
接口开发:庄焕滨,陈子洋
mrobot接口URL:http://mrobot.pcbaby.com.cn/s/qzbd/cms/shqlb.xsp
后端接口URL:http://www.pcbaby.com.cn/app/qzbd2/shqgd/
HTTP请求方式:get
是否需要登录:否
返回格式:JSON
缓存方式:无
缓存时间:无
请求参数:
v = 220 //版本号
返回参数
{
channels:[
{
id: 论坛id
name: 论坛名字
image: 论坛图片
des1: 论坛描述1
des2: 论坛描述2
}
]
}
3.2.3 最新列表,圈子-最新列表
备注:生活圈最新列表(接口已完成,使用请连开发机代理)
说明:1.新出接口,改为只出全站APP所发的最新内容,按照发帖时间倒序,需即时显示,含三个推广位;
2.生活圈-圈子-某个版块最新列表(按照发帖时间倒序,需即时显示,含一个推广位)
接口开发:丁健勇,陈子洋
mrobot接口URL:http://mrobot.pcbaby.com.cn/s/qzbd/bbs/getNewTopics.xsp
后端接口URL:http://bbs.pcbaby.com.cn/mobile/v2_2/getNewTopics.do
HTTP请求方式:get
是否需要登录:否
返回格式:JSON
缓存方式:无
缓存时间:无
请求参数:
fid=1;最新列表可不传该参数,默认fid=1;fid=1776;指定版块id
pageNo=1;页码
pageSize=10;每页条数
agent=2;2=亲子宝典IOS端,3=亲子宝典Android端
v = 220 //版本号
返回参数,成功:
{
fid: "1776", //版块id
pageNo: 1,
pageSize: 20,
topics: [
{
createAt: "2015-01-11 15:17:20", //发帖时间
message: "金币兑换的活动被我赶上好时候了。", //内容
replyCount: 3, //回复数
title: "【金币兑换】终于收到宝贝与我!", //标题
topicId: 2155710, //帖子ID
userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/25/23/72/54/25237254_50x50", //用户头像
userId: 25237254, //用户ID
userName: "馨悦妈妈", //用户昵称
viewCount: 20, //帖子查看数
recommend: 0, //是否为推广位数据:0=否;1=是
}
],
total: 639 //总条数
}
3.3 回帖
备注:回帖、回楼接口
(参照接口:http://trac.pc.com.cn/iphone/wiki/baby/interface#a4.5回帖接口)
1、请求参数增加:type(判断来自哪里的回楼、回帖,1:私密圈 2:生活圈);agent:终端类型(WAP:1、iOS:2、ANDROID:3)
2、私密圈回楼、回帖,返回参数增加提示,判断该帖子内人数是否已超过300人
3、回帖、回楼都改为不可匿名
接口开发:丁健勇
后端接口URL:http://bbs.pcbaby.com.cn/rest/topics.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:JSON
缓存方式:无
缓存时间:无
请求参数:
topicId: 主题ID
type: 1=私密圈回帖,2=生活圈回帖
anonymous: 是否匿名,1为匿名,0为不匿名,默认为0
agent: 终端类型(亲子宝典ios:2、亲子宝典android:3)
message: 回帖内容
replyToId: 回复楼层的帖子id
设置header Cookie = "common_session_id=xxxx"
返回参数:
发帖成功,返回HTTP响应头为201,即内容创建成功
{
"Location": "http://bbs.pcbaby.com.cn/post-2156187_39095567.html",
"status":0
}
私密圈返回参数(新增)
{
"status":-1,
"message": "此贴太火爆,快去其他帖子参与互动吧" //提示信息
}
3.4 发帖
备注:发帖接口
(参照接口:http://trac.pc.com.cn/iphone/wiki/baby/interface#a4.4发帖接口)
接口开发:丁健勇
后端接口URL:http://bbs.pcbaby.com.cn/rest/forums.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:JSON
缓存方式:无
缓存时间:无
请求参数:
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";
返回参数:
发帖成功,返回HTTP响应头为201,即内容创建成功
{
"Location": "http://bbs.pcbaby.com.cn/topic-2156187.html", //帖子URL
"goldCount": 1, //发帖获得金币数量
"hasGold": true //发帖是否获得金币
"status":0
}
3.5 帖子终端页
备注:帖子终端页(接口已完成,使用请连开发机代理)
1、参照接口:http://trac.pc.com.cn/iphone/wiki/baby/interface#a4.3帖子终端
2、html页面,V2.2版本更改帖子终端样式
接口开发:mrobot
请求URL:http://mrobot.pcbaby.com.cn/v2/bbs/topics/2155848?pageNo=1&size=17&picRule=2&newQuote=true&v=220
后端接口URL:
http://bbs.pcbaby.com.cn/rest/topics/2155848?pageNo=1&size=17&picRule=2&newQuote=true&v=220&agent=0
http://mdata.pconline.com.cn/pcbaby/user/allFace.jsp?act=findUnusedFaceIds&topicId=2155848
http://mdata.pconline.com.cn/pcbaby/user/allFace.jsp?act=findAll
http://mdata.pconline.com.cn/pcbaby/user/userFace.jsp?topicId=2155848
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
/topics/2149994:帖子id;
size:帖子内容字体大小;
pageNo:当前所在页数;
picRule:图片默认显示规则,0为显示小图,1为显示文字链接;2为显示大图。
设置header Cookie = "common_session_id=xxxx";
v = 220 //版本号 (新增参数)
newQuote=true
返回参数
加入一段注释,注释内的内容为一段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.0 广告
备注:获取广告数据(接口已完成,使用请连开发机代理)
mrobot接口URL:http://mrobot.pcbaby.com.cn/v3/ad
后端接口URL:http://ivy.pconline.com.cn/adpuba/show?id=pc.khd.zx.btxfldxj.&media=js
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":"", //跳转的url
"vc-uri":"http://ivy.pcauto.com.cn/adpuba/show?adid=333659&id=auto.khd.zx.qdtdh.&media=js", //显示计数:显示一次,计数一次
"vc3d-uri":""
},
"rule":
{
"age":1, //进入页面1秒后开始显示广告
"delay":5, //广告显示时长:5秒
"interval":10 //进入同一终端页间隔<10s,不显示广告
}
},
"pckids.app.qzbd.cyt.sy.tl.": {//崔玉涛专栏广告
"ad": {
"cc-uri": "",
"cc3d-uri": "",
"image": "http://imgad0.pcbaby.com.cn/ivy/image/20153/30/14276788853330.jpg",
"to-uri": "http://ivy.pcbaby.com.cn/adpuba/click?adid=361212&id=pckids.app.qzbd.cyt.sy.tl.",
"vc-uri": "http://ivy.pcbaby.com.cn/adpuba/show?adid=361212&id=pckids.app.qzbd.cyt.sy.tl.&media=js",
"vc3d-uri": ""
}
},
"pckids.app.qzbd.cyt.videoAd.": {//视频终端广告
"2102": {//视频id
"adImg": "", //预留暂停时动/静态广告图
"adImgDetailUrl": "", //暂停图片点击时的跳转
"adTime": 2, //暂停图片点击时的跳转
"media": "http://imgad0.pconline.com.cn/ivy/image/20151/29/14225177691890.mp4", //视频广告链接
"to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=355494&id=test.adtest.baby_app_tp.", //点击视频跳转的详情链接
"vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=355494&id=test.adtest.baby_app_tp.&media=js"
},
"2103": {
"adImg": "",
"adImgDetailUrl": "",
"adTime": 2,
"media": "http://imgad0.pconline.com.cn/ivy/image/20151/29/14225177691890.mp4",
"to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=353375&id=test.adtest.gg_test1.",
"vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=355494&id=test.adtest.baby_app_tp.&media=js"
}
},
"pckids.app.qzbd.cyt.askAd.": {//问答终端广告
"1": {//问答分类id
"image": "http://imgad0.pconline.com.cn/ivy/image/20152/4/14230450471470.jpg",//广告图片
"to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=355605&id=test.adtest.wd_dbtl.",//点击广告后跳转的详情链接
"vc-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=355605&id=test.adtest.wd_dbtl.&"
},
"2": {
"image": "http://imgad0.pconline.com.cn/ivy/image/20152/4/14230450973060.jpg",
"to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=355687&id=test.adtest.wd_dbtl2.",
"vc-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=355687&id=test.adtest.wd_dbtl2.&"
},
"3": {
"image": "http://imgad0.pconline.com.cn/ivy/image/20152/4/14230451209850.jpg",
"to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=355688&id=test.adtest.wd_dbtl3.",
"vc-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=355688&id=test.adtest.wd_dbtl3.&"
},
"4": {
"image": "http://imgad0.pconline.com.cn/ivy/image/20152/4/14230450471470.jpg",
"to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=355590&id=test.adtest.app_cyt_jdt.",
"vc-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=355605&id=test.adtest.wd_dbtl.&"
},
"5": {
"image": "http://imgad0.pconline.com.cn/ivy/image/20152/4/14230450471470.jpg",
"to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=355689&id=test.adtest.app_cyt_jdt2.",
"vc-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=355605&id=test.adtest.wd_dbtl.&"
}
}
}
5.0 活动终端
备注:活动终端页
接口URL:http://play9.pcbaby.com.cn/baby140801/baby/index.jsp?fromapp
(活动url:点击活动列表协议pcbabybrowser://baby-webview/?url=http://baidu.com&title=每日签到 通过解析跳转链点中的URL和Title两个参数作为活动详情页的URL和状态栏标题,
活动url后面带参数fromapp)
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:fromapp
点击客户端分享跳转协议:pcbabybrowser://activity-share
用于视频播放的数据,需要在里面加入json
/*@_HTML_META_START_
{
"firstPic":"http://img0.pcbaby.com.cn/pcbaby/app/qzbd2/activity/1408/huanli.jpg", //分享图片
"title":"金币换礼 商城好礼随你换",
"preView":"下载亲子宝典app,参与“金币换礼”活动,商城众多母婴精选好礼即可兑换!如此省钱妙招,你怎能错过,还不赶紧来参与!",
"wap_url":"http://play9.pcbaby.com.cn/baby140801/baby/index.jsp?toapp=1" //分享url
}
_HTML_META_END_@*/
6.0 首页
备注:首页接口(接口已完成,使用请连开发机代理)
接口说明:参照亲子V2.1接口--http://trac.pc.com.cn/iphone/wiki/baby3_developers/interface#a1.0首页
根据参数 v=220,后端接口增加recommendChannel2, mrobot将recommendChannel替换成recommendChannel2内的数据返回
1)mrobot接口url:
备孕首页:http://mrobot.pcbaby.com.cn/v2/qzbd/home/1?v=220
怀孕首页:http://mrobot.pcbaby.com.cn/v2/qzbd/home/2?v=220
育儿首页:http://mrobot.pcbaby.com.cn/v2/qzbd/home/3?v=220
2)后端url:
备孕首页:http://www.pcbaby.com.cn/app/qzbd2/bysy/
怀孕首页:http://www.pcbaby.com.cn/app/qzbd2/hysy/
育儿首页:http://www.pcbaby.com.cn/app/qzbd2/yesy/
HTTP请求方式:get
是否需要登录:否
返回格式:JSON
是否有缓存:有
缓存时间:15分钟
请求参数:
{id} //栏目id
v = 220 //版本号
返回参数:
{
focus:[ //焦点图数据(增加视频类文章页、问答专栏详情的推广)
{
id: // id:"articleId=234&expertId=112&num=111"( 推“专栏详情”的推广时id为文章id&专家id&专栏期数id)
image:
title:
type:论坛(1列表、2终端);亲子学院(3列表、4终端);活动(5列表、6终端);工具(7终端);食谱(8终端);资讯(9终端);
问答(10终端);百科(11终端);崔玉涛视频(12视频文章终端);专栏详情(13)
url:(活动、工具终端打开需要url,不需要时为空字符串)
}
],
recommend:[ //四个推荐位内容
{
id:
image:
title:
type:论坛(1列表、2终端);亲子学院(3列表、4终端);活动(5列表、6终端);工具(7终端);食谱(8终端);资讯(9终端);问答(10终端);百科(11终端)
url:(活动、工具终端打开需要url,不需要时为空字符串)
}
],
recommendChannel:[ //热门栏目(增加家庭育儿)
{
title: //根据栏目名称跳转至对应模块
type: //热门栏目类型(type=5表示家庭育儿)
//type=1 阅读,type=2 百科,type=3 交流圈,type=4 每日知识,type=5 家庭育儿,type=6 问答,type=7 活动,type=8 工具,type=9 每日食谱
}
],
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"
}
]
}