Changes between Version 1 and Version 2 of baby2.6_developers/interface


Ignore:
Timestamp:
09/16/2015 12:28:13 PM (11 years ago)
Author:
wuhuixuan
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • baby2.6_developers/interface

    v1 v2  
    66  192.168.10.199:1080 ,连的是dev40的开发环境(192.168.75.40)[[BR]]  
    77 
    8 == 1.私密圈 == 
    9 ---------- 
    10 === 1.1私语列表 === 
    11 '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] 
    12 mrobot接口:http://mrobot.pcbaby.com.cn/s/qzbd/bbs/getSecretTopics.xsp [[BR]] 
    13 后端接口:http://bbs.pcbaby.com.cn/mobile/v2_2/getSecretTopics.do  
    14  
    15 **说明** 
    16  
    17 > 新增置顶的活动专区,活动帖个数最多两个,返回数据需要新增一个数组返回活动帖 [[BR]] 
    18  
    19 **缓存时间** 
    20  
    21 >无 
    22  
    23 **提交方式** 
    24  
    25 > GET 
    26  
    27 **是否登录** 
    28  
    29 > 否 
    30  
    31 **数据来源** 
    32  
    33 >论坛后台 
    34  
    35 **参数** 
    36  
    37 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| 
    38 ||type||列表类型||string|| ||是||1=私语,2=话题|| 
    39 ||pageNo||页码||string|| || ||页码|| 
    40 ||pageSize||每页条数||string|| || ||每页条数|| 
    41 ||maxLength||内容最大长度||string||240 || || || 
    42 ||agent||app类型||string|| || ||2=亲子宝典IOS端,3=亲子宝典Android端|| 
    43 ||v||app版本号||string|| || ||版本号,v=260|| 
    44 **返回** 
    45  
    46 {{{#!java 
    47 { 
    48   pageNo: 1,    //当前页码 
    49   pageSize: 20, //每页条数,这里具体是指topics的个数,不包括activitys的 
    50   total: 15163, //总数量 
    51   activitys://活动帖,最多两个 
    52   [  
    53    {  
    54      topicId: 2156386,          //帖子ID 
    55       title: "最难忘前任的那点",    //标题 
    56     } 
    57    ], 
    58   topics: [ 
    59     {  
    60       topicId: 2156386,          //帖子ID 
    61       title: "最难忘前任的那点",    //标题 
    62       message: "最难忘前任的那点", //帖子内容(当recommend=1且recommendType=3时,这里为“引导话题贴内容”) 
    63       createAt: "2015-01-12 14:34:15",    //发帖时间 
    64       viewCount: 2,  //帖子浏览数  
    65       replyCount: 0,  //帖子回复数 
    66       recommend: 0, //是否推广位数据:0=否;1=是 
    67       recommendType: 1, //私语列表推广类型:1=话题贴通显推广;2=私密贴推广;3= 话题引导贴推广(当接口数据为话题列表数据时,该字段为0)   
    68       tagName: "杜蕾斯专场",  //专场标签(string类型,字段为空时表示无标签) 
    69       guestName: "毒舌辣妈", //特邀嘉宾标签 (string类型,字段为空时表示无标签) 
    70     } 
    71   ] 
    72 } 
    73  
    74 }}} 
    75 **返回参数说明** 
    76 ||= 参数名 =||= 参数含义 =|| 
    77 ||activitys||活动帖,个数最多两个|| 
    78  
    79 ---------- 
    80 === 1.2闺蜜专栏列表 === 
    81 '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] 
    82 mrobot接口:http://mrobot.pcbaby.com.cn/s-300/qzbd/bbs/getColumns.xsp?pageNo=1&pageSize=10&agent=2 [[BR]] 
    83 后端接口:http://bbs.pcbaby.com.cn/mobile/v2_5/bestie/getColumns.do?pageNo=1&pageSize=10&agent=2 [[BR]] 
    84  
    85 **说明** 
    86  
    87 > 一至五个专栏,无需翻页,每个专栏数据包括:专栏头像、专栏用户名、签名、动态(最新两条) [[BR]] 
    88  
    89 **缓存时间** 
    90  
    91 >5min 
    92  
    93 **提交方式** 
    94  
    95 > GET 
    96  
    97 **是否登录** 
    98  
    99 > 否 
    100  
    101 **数据来源** 
    102  
    103 >论坛后台 
    104  
    105 **参数** 
    106  
    107 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| 
    108 ||pageNo||页码||string||1 || ||页码|| 
    109 ||pageSize||每页条数||string||5|| ||每页条数,可选范围1-100|| 
    110 ||agent||app类型||string|| || ||2=亲子宝典IOS端,3=亲子宝典Android端|| 
    111 ||callback||回调函数||string|| ||非必需 ||回调函数|| 
    112 ||v||app版本号||string|| || ||版本号,v=260|| 
    113  
    114 **返回** 
    115  
    116 {{{#!java 
    117 { 
    118 columns:  [ 
    119  { 
    120     signature: "专栏签名", //专栏签名 
    121     authorFace: "http://i1.3conline.com/images/upload/upc/face/28/10/47/07/28104707_150x150",//专栏头像 
    122     authorId: 28104707,//专栏id 
    123     authorName: "情感小编",//专栏用户名 
    124     topics: //最新两条动态 
    125      [{ 
    126         message: "#嫁到婆家感觉最委屈的事#", 
    127         source: 1, 
    128         title: "#嫁到婆家感觉最委屈的事#", 
    129         topicId: 3162373 
    130      }, 
    131      {}] 
    132   } 
    133  ] 
    134 } 
    135  
    136 }}} 
    137 **返回参数说明** 
    138 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    139 ||signature||专栏签名||authorFace||专栏头像|| 
    140 ||authorId||专栏id||authorName||专栏用户名|| 
    141 ||topics||最新两条动态|| 
    142  
    143 ---------- 
    144 === 1.3专栏详情列表 === 
    145 '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] 
    146 mrobot接口:http://mrobot.pcbaby.com.cn/s-300/qzbd/bbs/getUserColumn.xsp?uid=30454824&pageNo=1&pageSize=10&agent=2 [[BR]] 
    147 后端接口:http://bbs.pcbaby.com.cn/mobile/v2_5/bestie/getUserColumn.do?uid=30454824&pageNo=1&pageSize=10&agent=2 [[BR]] 
    148  
    149 **说明** 
    150  
    151 > 专栏列表,支持翻页 [[BR]] 
    152  
    153 **缓存时间** 
    154  
    155 >5min 
    156  
    157 **提交方式** 
    158  
    159 > GET 
    160  
    161 **是否登录** 
    162  
    163 > 否 
    164  
    165 **数据来源** 
    166  
    167 >论坛后台 
    168  
    169 **参数** 
    170  
    171 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| 
    172 ||uid||达人用户ID||string|| || ||达人用户ID|| 
    173 ||pageNo||页码||string||1 || ||页码|| 
    174 ||pageSize||每页条数||string||5|| ||每页条数,可选范围1-100|| 
    175 ||agent||app类型||string|| || ||2=亲子宝典IOS端,3=亲子宝典Android端|| 
    176 ||callback||回调函数||string|| ||非必需 ||回调函数|| 
    177 ||v||app版本号||string|| || ||版本号,v=260|| 
    178  
    179 **返回** 
    180  
    181 {{{#!java 
    182 { 
    183   pageNo: 1, 
    184   pageSize: 20, 
    185   topics: [ 
    186   { 
    187     message: "#嫁到婆家感觉最委屈的事#", 
    188     replyContent: "从生活了二十几年的环境,出嫁到一个陌生的环境,你是否感到诸多不惯?不同的家庭有着不同的生活习惯,你需要时间去慢慢适应。在这个过程中,有什么事让你感到委屈的吗? 回帖奖励:2015年8月25日前,踩中本帖总回复数20%、50%、80%分别奖20金币;踩中本帖第50楼、100、500、1000楼分别奖10金币。精彩回复被小编选定置顶,额外奖励10金币。 注意: 1、占领本帖前10楼的回复必须满20字,否则取消获奖资格。 2、同一用户只能占领前十楼之一,否则取消获奖资格。 3、回复不得灌水,若本帖回复数少于100,取消所有幸运楼层。", 
    189 replyTime: 1440386130000, 
    190     source: 1, 
    191     title: "#嫁到婆家感觉最委屈的事#", 
    192     topicId: 3162373, 
    193     viewCount: 2,  //帖子浏览数  
    194     replyCount: 0,  //帖子回复数 
    195   } 
    196   ], 
    197   total: 241 
    198 } 
    199  
    200 }}} 
    201 **返回参数说明** 
    202 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| 
    203  
    204  
    205 ---------- 
    206  
    207 === 1.4发帖 === 
    208 '''(后端接口已完成)'''[[BR]] 
    209 后端正式接口:http://bbs.pcbaby.com.cn/rest/forums.jsp [[BR]] 
    210 后端测试接口:http://v14.pcbaby.com.cn/rest/forums.jsp [[BR]] 
    211  
    212 **说明** 
    213  
    214 > 发帖加上标签(后台可根据标签搜索),专栏发帖能通知到知心姐姐,接口说明http://trac.pc.com.cn/iphone/wiki/baby2.2_developers/interface#a3.4发帖 [[BR]] 
    215  
    216 **缓存时间** 
    217  
    218 >无 
    219  
    220 **提交方式** 
    221  
    222 > POST 
    223  
    224 **是否登录** 
    225  
    226 > 是 
    227  
    228 **数据来源** 
    229  
    230 >论坛后台 
    231  
    232 **参数** 
    233  
    234 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| 
    235 ||forumId ||论坛ID||string|| || ||论坛ID|| 
    236 ||title ||帖子标题||string|| || ||帖子标题|| 
    237 ||anonymous ||是否匿名||string|| || ||1,匿名;0,不匿名|| 
    238 ||agent||app类型||string|| || ||2=亲子宝典IOS端,3=亲子宝典Android端|| 
    239 ||category||发帖分类||string|| || ||留空时为“原创”|| 
    240 ||message ||发帖内容||string|| || ||发帖内容|| 
    241 ||bUid  ||闺蜜专栏用户ID||string|| || ||加此参数时,发完贴会通知该uid对应的达人用户|| 
    242  
    243 **返回** 
    244  
    245 {{{#!java 
    246  
    247 a:forumId不合法时:(响应码:404) 
    248 { 
    249   "status" : 5 
    250   "message" : "找不到对应的论坛"  
    251 } 
    252  
    253 b:没有发帖权限时:(响应码:401) 
    254 返回消息格式同a,失败原因包含在message字段。 
    255  
    256 c:其他校验不通过时:(响应码:401) 
    257 返回消息格式同a,失败原因包含在message字段。 
    258  
    259 d:超过最大发帖数时:(响应码:401) 
    260 返回消息格式同a,失败原因包含在message字段。 
    261  
    262 e:标题为空时:(响应码:400) 
    263 返回消息格式同a,失败原因包含在message字段。 
    264  
    265 f:内容为空时:(响应码:400) 
    266 返回消息格式同a,失败原因包含在message字段。 
    267  
    268 g:标题为空时:(响应码:400) 
    269 返回消息格式同a,失败原因包含在message字段。 
    270  
    271 h:发到私密圈版块包含图片时:(响应码:400) 
    272 返回消息格式同a,失败原因包含在message字段。 
    273  
    274 i:其他异常:(响应码:500) 
    275 返回消息格式同a,失败原因包含在message字段。 
    276  
    277 j:发帖成功时:(响应码:201) 
    278 { 
    279   "status" : 0 
    280   "Location":"帖子URL", 
    281   "hasGold":true, 
    282   "goldCount":3 
    283 } 
    284  
    285 }}} 
    286 **返回参数说明** 
    287 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| 
    288  
    289  
    290 ---------- 
    291 == 2.生活圈 == 
    292 ---------- 
    293  
    294  
    295 === 2.1潮妈、圈子精华列表 === 
    296 '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] 
    297 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 [[BR]] 
    298 后端接口: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 
    299  
    300 **说明** 
    301  
    302 > 潮妈列表新增活动专区数据,圈子精华列表新增字段标明是否推广位,接口说明http://trac.pc.com.cn/iphone/wiki/baby2.2_developers/interface#a3.2.1潮妈圈子精华列表 [[BR]] 
    303  
    304 **缓存时间** 
    305  
    306 >5min 
    307  
    308 **提交方式** 
    309  
    310 > GET 
    311  
    312 **是否登录** 
    313  
    314 > 否 
    315  
    316 **数据来源** 
    317  
    318 >论坛后台 
    319  
    320 **参数** 
    321  
    322 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| 
    323 ||forums||需要查询的版块ID||string|| || ||需要查询的版块ID,多个版块ID用半角逗号分隔。查找的信息也会包含其子版块。默认查询所有版块|| 
    324 ||noForums||要过滤的版块ID||string|| || ||要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块 || 
    325 ||agent||app类型||string|| || ||2=亲子宝典IOS端,3=亲子宝典Android端|| 
    326 ||pickType||精华类型||string||pickA || ||可选范围为,all,pickA,pickB,pick1,pick2,pick3,pick4,pick5。其中pickA和pickB查的都是普通精华,all为查询所有精华|| 
    327 ||maxLength||帖子内容需要截取的长度||string||240 || ||帖子内容需要截取的长度|| 
    328 ||callback||回调函数||string|| || ||回调函数|| 
    329 ||ie||输出内容的编码格式||string||GBK || ||输出内容的编码格式|| 
    330 ||showImage||是否输出帖子图片数组(前3张)||string|| || ||是否输出帖子图片数组(前3张)|| 
    331 ||requestScr||切换大小图||string||PC || ||当requestScr=wap时,结果中的images[]帖子图片尺寸大小为240*160|| 
    332 ||showSubject||是否显示论坛话题分类(最多3个)||string|| || ||是否显示论坛话题分类(最多3个)|| 
    333 ||pageNo||页码||string|| || ||页码|| 
    334 ||pageSize||每页条数||string|| || ||每页条数|| 
    335 ||showExtend||是否显示精华推广帖||string||false || ||默认false。可选[true,false]|| 
    336 ||v||app版本号||string|| || ||版本号,v=260|| 
    337  
    338 **返回** 
    339  
    340 {{{#!java 
    341 { 
    342   desc: "查询成功", 
    343   pageNo: 1, 
    344   pageSize: 20, 
    345   status: 0, 
    346   activitys://活动帖,最多两个 
    347   [  
    348    {  
    349      topicId: 2156386,          //帖子ID 
    350       title: "最难忘前任的那点",    //标题 
    351     } 
    352    ], 
    353   topics: [ 
    354     { 
    355     recommend:1,//标明是否推荐位,1是推荐位 
    356     babyBirthday: "", 
    357     bonus: -1, 
    358     containImage: true, 
    359     createAt: "2015-08-25 21:25:20", 
    360     createTime: 1440509120476, 
    361     forumId: 1917, 
    362     forumName: "宝宝秀场", 
    363     hasDoctorReply: false, 
    364     hasMummyMedia: false, 
    365     images: [], 
    366     message: "拍摄于中大校园 。 ", 
    367     pickTypes: {}, 
    368     replyCount: 0, 
    369     title: "短发萌娃元元的夏天。", 
    370     topicId: 3171428, 
    371     userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/12/65/76/7/1265767_70x70", 
    372     userId: 1265767, 
    373     userName: "啃蘋果的壞蛋", 
    374     views: 40 
    375     }], 
    376   total: 927 
    377 } 
    378 }}} 
    379 **返回参数说明** 
    380 ||= 参数名 =||= 参数含义 =|| 
    381 ||recommend||是否推广位数据:0=否;1=是|| 
    382 ||activitys||活动帖,最多两个|| 
    383  
    384 ---------- 
    385 === 2.2帖子终端页 === 
    386 '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] 
    387 mrobot接口:http://mrobot.pcbaby.com.cn/v2/bbs/topics/3171428?pageNo=1&size=17&picRule=2&v=240&newQuote=true [[BR]] 
    388 后端接口: 
    389           http://bbs.pcbaby.com.cn/rest/topics/2155848?pageNo=1&size=17&picRule=2&newQuote=true&v=220&agent=0 [[BR]] 
    390           http://mdata.pconline.com.cn/pcbaby/user/allFace.jsp?act=findUnusedFaceIds&topicId=2155848 [[BR]] 
    391           http://mdata.pconline.com.cn/pcbaby/user/allFace.jsp?act=findAll [[BR]] 
    392           http://mdata.pconline.com.cn/pcbaby/user/userFace.jsp?topicId=2155848 [[BR]] 
    393  
    394 **说明** 
    395  
    396 > 回复按倒序排(新增传参),即最新的在最前面,图片采用400*的尺寸,接口说明http://trac.pc.com.cn/iphone/wiki/baby2.2_developers/interface#a3.5帖子终端页 [[BR]] 
    397  
    398 **缓存时间** 
    399  
    400 >无 
    401  
    402 **提交方式** 
    403  
    404 > GET 
    405  
    406 **是否登录** 
    407  
    408 > 否 
    409  
    410 **数据来源** 
    411  
    412 >论坛后台 
    413  
    414 **参数** 
    415  
    416 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| 
    417 ||reverse||回复的排序方式||string|| || ||0为倒序,1为正序|| 
    418 ||topics||帖子id||string||无||是||帖子id|| 
    419 ||size||帖子内容字体大小||string|| || || || 
    420 ||pageNo||当前所在页数||string|| || || || 
    421 ||picRule||图片默认显示规则||string|| || ||0为显示小图,1为显示文字链接;2为显示大图|| 
    422 ||v||版本号||string|| || ||v=260|| 
    423 ||newQuote||控制新旧版回帖引用内容的样式||string||false || ||true或false,默认false|| 
    424 ||desc||是否倒序显示回帖(主楼除外)||string||false || ||true或false,默认false|| 
    425 >设置header  Cookie = "common_session_id=xxxx" 
    426  
    427 **返回** 
    428 >html页面 
    429  
    430 ----------