Changes between Version 41 and Version 42 of baby2.5_developers/interface


Ignore:
Timestamp:
09/08/2015 09:49:09 AM (11 years ago)
Author:
wuhuixuan
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • baby2.5_developers/interface

    v41 v42  
    11[[TOC]] 
    22 
    3 = 亲子宝典2.6.0接口文档 = 
     3= 亲子宝典2.5.0接口文档 = 
    44>mrobot代理环境说明：  
    55  192.168.10.198:1080(192.168.74.80)[[BR]]  
    66  192.168.10.199:1080 ，连的是dev40的开发环境（192.168.75.40）[[BR]]  
    77 
    8 == 1.私密圈 == 
    98---------- 
    10 === 1.1私语列表 === 
     9== 1.广告 == 
    1110'''(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  
     11mrobot接口：http://mrobot.pcbaby.com.cn/v3/ad?v=250 [[BR]] 
     12后端接口：  
    1413 
    1514**说明** 
    1615 
    17 > 新增置顶的活动专区，活动帖个数最多两个，返回数据需要新增一个数组返回活动帖 [[BR]] 
     16> 崔玉涛问答终端页（pckids.app.qzbd.cyt.askAd.）广告数据返回新增一个字段showJDAd，用于标识当前广告位置是否出京东广告 [[BR]] 
    1817 
    1918**缓存时间** 
    … …  
    3130**数据来源** 
    3231 
    33 >论坛后台 
     32>广告系统 
    3433 
    3534**参数** 
    3635 
    3736||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| 
    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|| 
     37||v||app版本号||string|| || ||版本号，v=250|| 
    4438**返回** 
    4539 
    4640{{{#!java 
    4741{ 
    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   ] 
    7242} 
    7343 
    … …  
    7545**返回参数说明** 
    7646||= 参数名 =||= 参数含义 =|| 
    77 ||activitys||活动帖，个数最多两个|| 
    7847 
    7948---------- 
    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]] 
     49== 2.京东广告接口 == 
     50**数据接口文档** 
    8451 
    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  
     52**对应数据表** 
    14353---------- 
    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 ----------