wiki:baby2.6_developers/interface

亲子宝典2.6.0接口文档

mrobot代理环境说明:

192.168.10.198:1080(192.168.74.80)
192.168.10.199:1080 ,连的是dev40的开发环境(192.168.75.40)


4.私密圈


4.1私语列表

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pcbaby.com.cn/s/qzbd/bbs/getSecretTopics.xsp
后端接口: http://bbs.pcbaby.com.cn/mobile/v2_2/getSecretTopics.do

说明

新增置顶的活动专区,活动帖个数最多两个,返回数据需要新增一个数组返回活动帖

缓存时间

提交方式

GET

是否登录

数据来源

论坛后台

参数

参数名 参数含义 类型 默认值 是否必需 说明
type列表类型string 1=私语,2=话题
pageNo页码string 页码
pageSize每页条数string 每页条数
maxLength内容最大长度string240
agentapp类型string 2=亲子宝典IOS端,3=亲子宝典Android端
vapp版本号string 版本号,v=260

返回

{
  pageNo: 1,    //当前页码
  pageSize: 20, //每页条数,这里具体是指topics的个数,不包括activitys的
  total: 15163, //总数量
  activitys://活动帖,最多两个
  [ 
   { 
     topicId: 2156386,          //帖子ID
      title: "最难忘前任的那点",    //标题
    }
   ],
  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类型,字段为空时表示无标签)
    }
  ]
}

返回参数说明

参数名 参数含义
activitys活动帖,个数最多两个

4.2闺蜜专栏列表

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pcbaby.com.cn/s-300/qzbd/bbs/getColumns.xsp?pageNo=1&pageSize=10&agent=2
后端接口: http://bbs.pcbaby.com.cn/mobile/v2_5/bestie/getColumns.do?pageNo=1&pageSize=10&agent=2

说明

一至五个专栏,无需翻页,每个专栏数据包括:专栏头像、专栏用户名、签名、动态(最新两条)

缓存时间

5min

提交方式

GET

是否登录

数据来源

论坛后台

参数

参数名 参数含义 类型 默认值 是否必需 说明
pageNo页码string1 页码
pageSize每页条数string5 每页条数,可选范围1-100
agentapp类型string 2=亲子宝典IOS端,3=亲子宝典Android端
callback回调函数string 非必需 回调函数
vapp版本号string 版本号,v=260

返回

{
columns:  [
 {
    signature: "专栏签名", //专栏签名
    authorFace: "http://i1.3conline.com/images/upload/upc/face/28/10/47/07/28104707_150x150",//专栏头像
    authorId: 28104707,//专栏id
    authorName: "情感小编",//专栏用户名
    topics: //最新两条动态
     [{
        message: "#嫁到婆家感觉最委屈的事#",
        source: 1,
        title: "#嫁到婆家感觉最委屈的事#",
        topicId: 3162373
     },
     {}]
  }
 ]
}

返回参数说明

参数名 参数含义 参数名参数含义
signature专栏签名authorFace专栏头像
authorId专栏idauthorName专栏用户名
topics最新两条动态

4.3专栏详情列表

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pcbaby.com.cn/s-300/qzbd/bbs/getUserColumn.xsp?uid=30454824&pageNo=1&pageSize=10&agent=2
后端接口: http://bbs.pcbaby.com.cn/mobile/v2_5/bestie/getUserColumn.do?uid=30454824&pageNo=1&pageSize=10&agent=2

说明

专栏列表,支持翻页

缓存时间

5min

提交方式

GET

是否登录

数据来源

论坛后台

参数

参数名 参数含义 类型 默认值 是否必需 说明
uid达人用户IDstring 达人用户ID
pageNo页码string1 页码
pageSize每页条数string5 每页条数,可选范围1-100
agentapp类型string 2=亲子宝典IOS端,3=亲子宝典Android端
callback回调函数string 非必需 回调函数
vapp版本号string 版本号,v=260

返回

{
  pageNo: 1,
  pageSize: 20,
  topics: [
  {
    message: "#嫁到婆家感觉最委屈的事#",
    replyContent: "从生活了二十几年的环境,出嫁到一个陌生的环境,你是否感到诸多不惯?不同的家庭有着不同的生活习惯,你需要时间去慢慢适应。在这个过程中,有什么事让你感到委屈的吗? 回帖奖励:2015年8月25日前,踩中本帖总回复数20%、50%、80%分别奖20金币;踩中本帖第50楼、100、500、1000楼分别奖10金币。精彩回复被小编选定置顶,额外奖励10金币。 注意: 1、占领本帖前10楼的回复必须满20字,否则取消获奖资格。 2、同一用户只能占领前十楼之一,否则取消获奖资格。 3、回复不得灌水,若本帖回复数少于100,取消所有幸运楼层。",
replyTime: 1440386130000,
    source: 1,
    title: "#嫁到婆家感觉最委屈的事#",
    topicId: 3162373,
    viewCount: 2,  //帖子浏览数 
    replyCount: 0,  //帖子回复数
  }
  ],
  total: 241
}

返回参数说明

参数名 参数含义 参数名参数含意

4.4发帖

(后端接口已完成)
后端正式接口: http://bbs.pcbaby.com.cn/rest/forums.jsp
后端测试接口: http://v14.pcbaby.com.cn/rest/forums.jsp

说明

发帖加上标签(后台可根据标签搜索),专栏发帖能通知到知心姐姐,接口说明 http://trac.pc.com.cn/iphone/wiki/baby2.2_developers/interface#a3.4发帖

缓存时间

提交方式

POST

是否登录

数据来源

论坛后台

参数

参数名 参数含义 类型 默认值 是否必需 说明
forumId 论坛IDstring 论坛ID
title 帖子标题string 帖子标题
anonymous 是否匿名string 1,匿名;0,不匿名
agentapp类型string 2=亲子宝典IOS端,3=亲子宝典Android端
category发帖分类string 留空时为“原创”
message 发帖内容string 发帖内容
bUid 闺蜜专栏用户IDstring 加此参数时,发完贴会通知该uid对应的达人用户

返回

a:forumId不合法时:(响应码:404)
{
  "status" : 5
  "message" : "找不到对应的论坛" 
}

b:没有发帖权限时:(响应码:401)
返回消息格式同a,失败原因包含在message字段。

c:其他校验不通过时:(响应码:401)
返回消息格式同a,失败原因包含在message字段。

d:超过最大发帖数时:(响应码:401)
返回消息格式同a,失败原因包含在message字段。

e:标题为空时:(响应码:400)
返回消息格式同a,失败原因包含在message字段。

f:内容为空时:(响应码:400)
返回消息格式同a,失败原因包含在message字段。

g:标题为空时:(响应码:400)
返回消息格式同a,失败原因包含在message字段。

h:发到私密圈版块包含图片时:(响应码:400)
返回消息格式同a,失败原因包含在message字段。

i:其他异常:(响应码:500)
返回消息格式同a,失败原因包含在message字段。

j:发帖成功时:(响应码:201)
{
  "status" : 0
  "Location":"帖子URL",
  "hasGold":true,
  "goldCount":3
}

返回参数说明

参数名 参数含义 参数名参数含意

5.生活圈


5.1潮妈、圈子精华列表

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pcbaby.com.cn/s-300/qzbd/bbs/getPicks.xsp?ie=utf-8&pageSize=20&pickType=pick3&maxLength=240&forums=1917,2130,1828,1799,1820,2140,1771,1776,2200&requestScr=wap&agent=2&noForums=1929&pageNo=1&cacheTime=1200&v=240&showImage=true
后端接口: http://bbs.pcbaby.com.cn/intf/forum/getPicks.do?ie=utf-8&pageSize=20&pickType=pick3&maxLength=240&forums=1917,2130,1828,1799,1820,2140,1771,1776,2200&requestScr=wap&agent=2&noForums=1929&pageNo=1&cacheTime=1200&v=240&showImage=true

说明

潮妈列表新增活动专区数据,圈子精华列表新增字段标明是否推广位,接口说明 http://trac.pc.com.cn/iphone/wiki/baby2.2_developers/interface#a3.2.1潮妈圈子精华列表

缓存时间

5min

提交方式

GET

是否登录

数据来源

论坛后台

参数

参数名 参数含义 类型 默认值 是否必需 说明
forums需要查询的版块IDstring 需要查询的版块ID,多个版块ID用半角逗号分隔。查找的信息也会包含其子版块。默认查询所有版块
noForums要过滤的版块IDstring 要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块
agentapp类型string 2=亲子宝典IOS端,3=亲子宝典Android端
pickType精华类型stringpickA 可选范围为,all,pickA,pickB,pick1,pick2,pick3,pick4,pick5。其中pickA和pickB查的都是普通精华,all为查询所有精华
maxLength帖子内容需要截取的长度string240 帖子内容需要截取的长度
callback回调函数string 回调函数
ie输出内容的编码格式stringGBK 输出内容的编码格式
showImage是否输出帖子图片数组(前3张)string 是否输出帖子图片数组(前3张)
requestScr切换大小图stringPC 当requestScr=wap时,结果中的images[]帖子图片尺寸大小为240*160
showSubject是否显示论坛话题分类(最多3个)string 是否显示论坛话题分类(最多3个)
pageNo页码string 页码
pageSize每页条数string 每页条数
showExtend是否显示精华推广帖stringfalse 默认false。可选[true,false]
vapp版本号string 版本号,v=260

返回

{
  desc: "查询成功",
  pageNo: 1,
  pageSize: 20,
  status: 0,
  activitys://活动帖,最多两个
  [ 
   { 
     topicId: 2156386,          //帖子ID
      title: "最难忘前任的那点",    //标题
    }
   ],
  topics: [
    {
    recommend:1,//标明是否推荐位,1是推荐位
    babyBirthday: "",
    bonus: -1,
    containImage: true,
    createAt: "2015-08-25 21:25:20",
    createTime: 1440509120476,
    forumId: 1917,
    forumName: "宝宝秀场",
    hasDoctorReply: false,
    hasMummyMedia: false,
    images: [],
    message: "拍摄于中大校园 。 ",
    pickTypes: {},
    replyCount: 0,
    title: "短发萌娃元元的夏天。",
    topicId: 3171428,
    userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/12/65/76/7/1265767_70x70",
    userId: 1265767,
    userName: "啃蘋果的壞蛋",
    views: 40
    }],
  total: 927
}

返回参数说明

参数名 参数含义
recommend是否推广位数据:0=否;1=是
activitys活动帖,最多两个

5.2帖子终端页

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pcbaby.com.cn/v2/bbs/topics/3171428?pageNo=1&size=17&picRule=2&v=240&newQuote=true
后端接口:

 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

说明

回复按倒序排(新增传参),即最新的在最前面,图片采用400*的尺寸,接口说明 http://trac.pc.com.cn/iphone/wiki/baby2.2_developers/interface#a3.5帖子终端页

缓存时间

提交方式

GET

是否登录

数据来源

论坛后台

参数

设置header Cookie = "common_session_id=xxxx"

参数名 参数含义 类型 默认值 是否必须 说明
reverse回复的排序方式string 0为倒序,1为正序
topics帖子idstring帖子id
size帖子内容字体大小string
pageNo当前所在页数string
picRule图片默认显示规则string 0为显示小图,1为显示文字链接;2为显示大图
v版本号string v=260
newQuote控制新旧版回帖引用内容的样式stringfalse true或false,默认false
desc是否倒序显示回帖(主楼除外)stringfalse true或false,默认false

返回

html页面