Changes between Version 55 and Version 56 of baby2.5_developers/interface


Ignore:
Timestamp:
09/28/2015 02:18:56 PM (11 years ago)
Author:
wuhuixuan
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • baby2.5_developers/interface

    v55 v56  
    244244 
    245245**参数** 
    246  
    247 **返回** 
    248 html页面 
    249  
    250  
    251 ---------- 
    252 = 华丽的分割线 = 
    253 ---------- 
    254  
    255 == 4.私密圈 == 
    256 ---------- 
    257 === 4.1私语列表 === 
    258 '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] 
    259 mrobot接口:http://mrobot.pcbaby.com.cn/s/qzbd/bbs/getSecretTopics.xsp [[BR]] 
    260 后端接口:http://bbs.pcbaby.com.cn/mobile/v2_2/getSecretTopics.do  
    261  
    262 **说明** 
    263  
    264 > 新增置顶的活动专区,活动帖个数最多两个,返回数据需要新增一个数组返回活动帖 [[BR]] 
    265  
    266 **缓存时间** 
    267  
    268246>无 
    269  
    270 **提交方式** 
    271  
    272 > GET 
    273  
    274 **是否登录** 
    275  
    276 > 否 
    277  
    278 **数据来源** 
    279  
    280 >论坛后台 
    281  
    282 **参数** 
    283  
    284 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| 
    285 ||type||列表类型||string|| ||是||1=私语,2=话题|| 
    286 ||pageNo||页码||string|| || ||页码|| 
    287 ||pageSize||每页条数||string|| || ||每页条数|| 
    288 ||maxLength||内容最大长度||string||240 || || || 
    289 ||agent||app类型||string|| || ||2=亲子宝典IOS端,3=亲子宝典Android端|| 
    290 ||v||app版本号||string|| || ||版本号,v=250|| 
    291 **返回** 
    292  
    293 {{{#!java 
    294 { 
    295   pageNo: 1,    //当前页码 
    296   pageSize: 20, //每页条数,这里具体是指topics的个数,不包括activitys的 
    297   total: 15163, //总数量 
    298   activitys://活动帖,最多两个 
    299   [  
    300    {  
    301      topicId: 2156386,          //帖子ID 
    302       title: "最难忘前任的那点",    //标题 
    303     } 
    304    ], 
    305   topics: [ 
    306     {  
    307       topicId: 2156386,          //帖子ID 
    308       title: "最难忘前任的那点",    //标题 
    309       message: "最难忘前任的那点", //帖子内容(当recommend=1且recommendType=3时,这里为“引导话题贴内容”) 
    310       createAt: "2015-01-12 14:34:15",    //发帖时间 
    311       viewCount: 2,  //帖子浏览数  
    312       replyCount: 0,  //帖子回复数 
    313       recommend: 0, //是否推广位数据:0=否;1=是 
    314       recommendType: 1, //私语列表推广类型:1=话题贴通显推广;2=私密贴推广;3= 话题引导贴推广(当接口数据为话题列表数据时,该字段为0)   
    315       tagName: "杜蕾斯专场",  //专场标签(string类型,字段为空时表示无标签) 
    316       guestName: "毒舌辣妈", //特邀嘉宾标签 (string类型,字段为空时表示无标签) 
    317     } 
    318   ] 
    319 } 
    320  
    321 }}} 
    322 **返回参数说明** 
    323 ||= 参数名 =||= 参数含义 =|| 
    324 ||activitys||活动帖,个数最多两个|| 
    325  
    326 ---------- 
    327 === 4.2闺蜜专栏列表 === 
    328 '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] 
    329 mrobot接口:http://mrobot.pcbaby.com.cn/s-300/qzbd/bbs/getColumns.xsp?pageNo=1&pageSize=10&agent=2 [[BR]] 
    330 后端接口:http://bbs.pcbaby.com.cn/mobile/v2_5/bestie/getColumns.do?pageNo=1&pageSize=10&agent=2 [[BR]] 
    331  
    332 **说明** 
    333  
    334 > 一至五个专栏,无需翻页,每个专栏数据包括:专栏头像、专栏用户名、签名、动态(最新两条) [[BR]] 
    335  
    336 **缓存时间** 
    337  
    338 >5min 
    339  
    340 **提交方式** 
    341  
    342 > GET 
    343  
    344 **是否登录** 
    345  
    346 > 否 
    347  
    348 **数据来源** 
    349  
    350 >论坛后台 
    351  
    352 **参数** 
    353  
    354 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| 
    355 ||pageNo||页码||string||1 || ||页码|| 
    356 ||pageSize||每页条数||string||5|| ||每页条数,可选范围1-100|| 
    357 ||agent||app类型||string|| || ||2=亲子宝典IOS端,3=亲子宝典Android端|| 
    358 ||callback||回调函数||string|| ||非必需 ||回调函数|| 
    359 ||v||app版本号||string|| || ||版本号,v=250|| 
    360  
    361 **返回** 
    362  
    363 {{{#!java 
    364 { 
    365 columns:  [ 
    366  { 
    367     signature: "专栏签名", //专栏签名 
    368     authorFace: "http://i1.3conline.com/images/upload/upc/face/28/10/47/07/28104707_150x150",//专栏头像 
    369     authorId: 28104707,//专栏id 
    370     authorName: "情感小编",//专栏用户名 
    371     topics: //最新两条动态 
    372      [{ 
    373         message: "#嫁到婆家感觉最委屈的事#", 
    374         source: 1, 
    375         title: "#嫁到婆家感觉最委屈的事#", 
    376         topicId: 3162373 
    377      }, 
    378      {}] 
    379   } 
    380  ] 
    381 } 
    382  
    383 }}} 
    384 **返回参数说明** 
    385 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    386 ||signature||专栏签名||authorFace||专栏头像|| 
    387 ||authorId||专栏id||authorName||专栏用户名|| 
    388 ||topics||最新两条动态|| 
    389  
    390 ---------- 
    391 === 4.3专栏详情列表 === 
    392 '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] 
    393 mrobot接口:http://mrobot.pcbaby.com.cn/s-300/qzbd/bbs/getUserColumn.xsp?uid=30454824&pageNo=1&pageSize=10&agent=2 [[BR]] 
    394 后端接口:http://bbs.pcbaby.com.cn/mobile/v2_5/bestie/getUserColumn.do?uid=30454824&pageNo=1&pageSize=10&agent=2 [[BR]] 
    395  
    396 **说明** 
    397  
    398 > 专栏列表,支持翻页 [[BR]] 
    399  
    400 **缓存时间** 
    401  
    402 >5min 
    403  
    404 **提交方式** 
    405  
    406 > GET 
    407  
    408 **是否登录** 
    409  
    410 > 否 
    411  
    412 **数据来源** 
    413  
    414 >论坛后台 
    415  
    416 **参数** 
    417  
    418 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| 
    419 ||uid||达人用户ID||string|| || ||达人用户ID|| 
    420 ||pageNo||页码||string||1 || ||页码|| 
    421 ||pageSize||每页条数||string||5|| ||每页条数,可选范围1-100|| 
    422 ||agent||app类型||string|| || ||2=亲子宝典IOS端,3=亲子宝典Android端|| 
    423 ||callback||回调函数||string|| ||非必需 ||回调函数|| 
    424 ||v||app版本号||string|| || ||版本号,v=250|| 
    425  
    426 **返回** 
    427  
    428 {{{#!java 
    429 { 
    430   pageNo: 1, 
    431   pageSize: 20, 
    432   topics: [ 
    433   { 
    434     message: "#嫁到婆家感觉最委屈的事#", 
    435     replyContent: "从生活了二十几年的环境,出嫁到一个陌生的环境,你是否感到诸多不惯?不同的家庭有着不同的生活习惯,你需要时间去慢慢适应。在这个过程中,有什么事让你感到委屈的吗? 回帖奖励:2015年8月25日前,踩中本帖总回复数20%、50%、80%分别奖20金币;踩中本帖第50楼、100、500、1000楼分别奖10金币。精彩回复被小编选定置顶,额外奖励10金币。 注意: 1、占领本帖前10楼的回复必须满20字,否则取消获奖资格。 2、同一用户只能占领前十楼之一,否则取消获奖资格。 3、回复不得灌水,若本帖回复数少于100,取消所有幸运楼层。", 
    436 replyTime: 1440386130000, 
    437     source: 1, 
    438     title: "#嫁到婆家感觉最委屈的事#", 
    439     topicId: 3162373, 
    440     viewCount: 2,  //帖子浏览数  
    441     replyCount: 0,  //帖子回复数 
    442   } 
    443   ], 
    444   total: 241 
    445 } 
    446  
    447 }}} 
    448 **返回参数说明** 
    449 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| 
    450  
    451  
    452 ---------- 
    453  
    454 === 4.4发帖 === 
    455 '''(后端接口已完成)'''[[BR]] 
    456 后端正式接口:http://bbs.pcbaby.com.cn/rest/forums.jsp [[BR]] 
    457 后端测试接口:http://v14.pcbaby.com.cn/rest/forums.jsp [[BR]] 
    458  
    459 **说明** 
    460  
    461 > 发帖加上标签(后台可根据标签搜索),专栏发帖能通知到知心姐姐,接口说明http://trac.pc.com.cn/iphone/wiki/baby2.2_developers/interface#a3.4发帖 [[BR]] 
    462  
    463 **缓存时间** 
    464  
    465 >无 
    466  
    467 **提交方式** 
    468  
    469 > POST 
    470  
    471 **是否登录** 
    472  
    473 > 是 
    474  
    475 **数据来源** 
    476  
    477 >论坛后台 
    478  
    479 **参数** 
    480  
    481 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| 
    482 ||forumId ||论坛ID||string|| || ||论坛ID|| 
    483 ||title ||帖子标题||string|| || ||帖子标题|| 
    484 ||anonymous ||是否匿名||string|| || ||1,匿名;0,不匿名|| 
    485 ||agent||app类型||string|| || ||2=亲子宝典IOS端,3=亲子宝典Android端|| 
    486 ||category||发帖分类||string|| || ||留空时为“原创”|| 
    487 ||message ||发帖内容||string|| || ||发帖内容|| 
    488 ||bUid  ||闺蜜专栏用户ID||string|| || ||加此参数时,发完贴会通知该uid对应的达人用户|| 
    489  
    490 **返回** 
    491  
    492 {{{#!java 
    493  
    494 a:forumId不合法时:(响应码:404) 
    495 { 
    496   "status" : 5 
    497   "message" : "找不到对应的论坛"  
    498 } 
    499  
    500 b:没有发帖权限时:(响应码:401) 
    501 返回消息格式同a,失败原因包含在message字段。 
    502  
    503 c:其他校验不通过时:(响应码:401) 
    504 返回消息格式同a,失败原因包含在message字段。 
    505  
    506 d:超过最大发帖数时:(响应码:401) 
    507 返回消息格式同a,失败原因包含在message字段。 
    508  
    509 e:标题为空时:(响应码:400) 
    510 返回消息格式同a,失败原因包含在message字段。 
    511  
    512 f:内容为空时:(响应码:400) 
    513 返回消息格式同a,失败原因包含在message字段。 
    514  
    515 g:标题为空时:(响应码:400) 
    516 返回消息格式同a,失败原因包含在message字段。 
    517  
    518 h:发到私密圈版块包含图片时:(响应码:400) 
    519 返回消息格式同a,失败原因包含在message字段。 
    520  
    521 i:其他异常:(响应码:500) 
    522 返回消息格式同a,失败原因包含在message字段。 
    523  
    524 j:发帖成功时:(响应码:201) 
    525 { 
    526   "status" : 0 
    527   "Location":"帖子URL", 
    528   "hasGold":true, 
    529   "goldCount":3 
    530 } 
    531  
    532 }}} 
    533 **返回参数说明** 
    534 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| 
    535  
    536  
    537 ---------- 
    538 == 5.生活圈 == 
    539 ---------- 
    540  
    541  
    542 === 5.1潮妈、圈子精华列表 === 
    543 '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] 
    544 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]] 
    545 后端接口: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 
    546  
    547 **说明** 
    548  
    549 > 潮妈列表新增活动专区数据,圈子精华列表新增字段标明是否推广位,接口说明http://trac.pc.com.cn/iphone/wiki/baby2.2_developers/interface#a3.2.1潮妈圈子精华列表 [[BR]] 
    550  
    551 **缓存时间** 
    552  
    553 >5min 
    554  
    555 **提交方式** 
    556  
    557 > GET 
    558  
    559 **是否登录** 
    560  
    561 > 否 
    562  
    563 **数据来源** 
    564  
    565 >论坛后台 
    566  
    567 **参数** 
    568  
    569 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| 
    570 ||forums||需要查询的版块ID||string|| || ||需要查询的版块ID,多个版块ID用半角逗号分隔。查找的信息也会包含其子版块。默认查询所有版块|| 
    571 ||noForums||要过滤的版块ID||string|| || ||要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块 || 
    572 ||agent||app类型||string|| || ||2=亲子宝典IOS端,3=亲子宝典Android端|| 
    573 ||pickType||精华类型||string||pickA || ||可选范围为,all,pickA,pickB,pick1,pick2,pick3,pick4,pick5。其中pickA和pickB查的都是普通精华,all为查询所有精华|| 
    574 ||maxLength||帖子内容需要截取的长度||string||240 || ||帖子内容需要截取的长度|| 
    575 ||callback||回调函数||string|| || ||回调函数|| 
    576 ||ie||输出内容的编码格式||string||GBK || ||输出内容的编码格式|| 
    577 ||showImage||是否输出帖子图片数组(前3张)||string|| || ||是否输出帖子图片数组(前3张)|| 
    578 ||requestScr||切换大小图||string||PC || ||当requestScr=wap时,结果中的images[]帖子图片尺寸大小为240*160|| 
    579 ||showSubject||是否显示论坛话题分类(最多3个)||string|| || ||是否显示论坛话题分类(最多3个)|| 
    580 ||pageNo||页码||string|| || ||页码|| 
    581 ||pageSize||每页条数||string|| || ||每页条数|| 
    582 ||showExtend||是否显示精华推广帖||string||false || ||默认false。可选[true,false]|| 
    583 ||v||app版本号||string|| || ||版本号,v=250|| 
    584  
    585 **返回** 
    586  
    587 {{{#!java 
    588 { 
    589   desc: "查询成功", 
    590   pageNo: 1, 
    591   pageSize: 20, 
    592   status: 0, 
    593   activitys://活动帖,最多两个 
    594   [  
    595    {  
    596      topicId: 2156386,          //帖子ID 
    597       title: "最难忘前任的那点",    //标题 
    598     } 
    599    ], 
    600   topics: [ 
    601     { 
    602     recommend:1,//标明是否推荐位,1是推荐位 
    603     babyBirthday: "", 
    604     bonus: -1, 
    605     containImage: true, 
    606     createAt: "2015-08-25 21:25:20", 
    607     createTime: 1440509120476, 
    608     forumId: 1917, 
    609     forumName: "宝宝秀场", 
    610     hasDoctorReply: false, 
    611     hasMummyMedia: false, 
    612     images: [], 
    613     message: "拍摄于中大校园 。 ", 
    614     pickTypes: {}, 
    615     replyCount: 0, 
    616     title: "短发萌娃元元的夏天。", 
    617     topicId: 3171428, 
    618     userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/12/65/76/7/1265767_70x70", 
    619     userId: 1265767, 
    620     userName: "啃蘋果的壞蛋", 
    621     views: 40 
    622     }], 
    623   total: 927 
    624 } 
    625 }}} 
    626 **返回参数说明** 
    627 ||= 参数名 =||= 参数含义 =|| 
    628 ||recommend||是否推广位数据:0=否;1=是|| 
    629 ||activitys||活动帖,最多两个|| 
    630  
    631 ---------- 
    632 === 5.2帖子终端页 === 
    633 '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] 
    634 mrobot接口:http://mrobot.pcbaby.com.cn/v2/bbs/topics/3171428?pageNo=1&size=17&picRule=2&v=240&newQuote=true [[BR]] 
    635 后端接口: 
    636           http://bbs.pcbaby.com.cn/rest/topics/2155848?pageNo=1&size=17&picRule=2&newQuote=true&v=220&agent=0 [[BR]] 
    637           http://mdata.pconline.com.cn/pcbaby/user/allFace.jsp?act=findUnusedFaceIds&topicId=2155848 [[BR]] 
    638           http://mdata.pconline.com.cn/pcbaby/user/allFace.jsp?act=findAll [[BR]] 
    639           http://mdata.pconline.com.cn/pcbaby/user/userFace.jsp?topicId=2155848 [[BR]] 
    640  
    641 **说明** 
    642  
    643 > 回复按倒序排(新增传参),即最新的在最前面,图片采用400*的尺寸,接口说明http://trac.pc.com.cn/iphone/wiki/baby2.2_developers/interface#a3.5帖子终端页 [[BR]] 
    644  
    645 **缓存时间** 
    646  
    647 >无 
    648  
    649 **提交方式** 
    650  
    651 > GET 
    652  
    653 **是否登录** 
    654  
    655 > 否 
    656  
    657 **数据来源** 
    658  
    659 >论坛后台 
    660  
    661 **参数** 
    662  
    663 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| 
    664 ||reverse||回复的排序方式||string|| || ||0为倒序,1为正序|| 
    665 ||topics||帖子id||string||无||是||帖子id|| 
    666 ||size||帖子内容字体大小||string|| || || || 
    667 ||pageNo||当前所在页数||string|| || || || 
    668 ||picRule||图片默认显示规则||string|| || ||0为显示小图,1为显示文字链接;2为显示大图|| 
    669 ||v||版本号||string|| || ||v=250|| 
    670 ||newQuote||控制新旧版回帖引用内容的样式||string||false || ||true或false,默认false|| 
    671 ||desc||是否倒序显示回帖(主楼除外)||string||false || ||true或false,默认false|| 
    672 >设置header  Cookie = "common_session_id=xxxx" 
    673  
    674247**返回** 
    675248>html页面 
    676  
    677 ---------- 
     249>客户端调用页面提供的js方法传入京东数据:loadData() 
     250>传参为数组的string,数组元素为字典,包含字段:id(第几位广告)、title(广告描述)、adLink(点击广告的协议)、imgSrc(广告图片url)、extendJD(京东的图片曝光url)、extendPC(广告系统的曝光url) 
     251----------