Authored by tanling

Update 版块首页相关接口.md

@@ -270,3 +270,105 @@ code为200即为成功,否则是失败。 @@ -270,3 +270,105 @@ code为200即为成功,否则是失败。
270 } 270 }
271 ``` 271 ```
272 272
  273 +
  274 +## 4、社区首页最热帖子列表##
  275 +
  276 +社区首页最热帖子列表(method=app.social.getHomePagePostList)
  277 +#### 公共请求参数
  278 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  279 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  280 +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
  281 +|app_version|float|10|否|1||APP版本|
  282 +|os_version|string|20|否|Android4.4||系统版本+机器型号|
  283 +|client_type|string|20|否|iphone/android/ipad||手机型号(不区分大小写)|
  284 +|screen_size|string|20|否|800x900||(手机尺寸)|
  285 +
  286 +#### 请求参数
  287 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  288 +|:-------| -----:|-----:|-----:|-----:|----:|
  289 +|authorId|String|否|32423|0|作者id|
  290 +|page|int|是|1|1|页码|
  291 +|limit|int|是|5|10|每页多少条|
  292 +
  293 +注意,通用的头部没有列出。
  294 +请求示例
  295 +http://172.16.8.136:8080/gateway/?method=app.social.getHomePagePostList&authorId=2222222&page=1&limit=2&debug=XYZ
  296 +
  297 +### 响应
  298 +code为200即为成功,否则是失败。
  299 +响应JSON格式如下所示:
  300 +```json
  301 +{
  302 + "alg": "SALT_MD5",
  303 + "code": 200,
  304 + "data": {
  305 + "list": [
  306 + {
  307 + "isIndexTop": 0,
  308 + "blocks": [
  309 + {
  310 + "contentData": "http://img12.static.yhbimg.com/goodsimg/2016/06/06/05/02e8b4a63c0101b1a1a8f04b53d817b9d4.png",
  311 + "templateKey": "image",
  312 + "order": 1
  313 + },
  314 + {
  315 + "contentData": "http://img12.static.yhbimg.com/goodsimg/2016/06/06/05/02e8b4a63c0101b1a1a8f04b53d817b9d5.png",
  316 + "templateKey": "image",
  317 + "order": 2
  318 + }
  319 + ],
  320 + "updateTime": 0,
  321 + "praise": 0,
  322 + "revieweTime": 0,
  323 + "isForumTop": 0,
  324 + "forumName": "模块",
  325 + "createTime": 1467116319,
  326 + "forumCode": 10002,
  327 + "comment": 1,
  328 + "id": 64,
  329 + "revieweState": 0,
  330 + "isHot": 0,
  331 + "browse": 0,
  332 + "status": 0
  333 + },
  334 + {
  335 + "isIndexTop": 0,
  336 + "blocks": [
  337 + {
  338 + "contentData": "啊啊啊啊啊啊啊啊啊啊啊",
  339 + "templateKey": "text",
  340 + "order": 1
  341 + }
  342 + ],
  343 + "updateTime": 0,
  344 + "praise": 0,
  345 + "revieweTime": 0,
  346 + "isForumTop": 1,
  347 + "forumName": "模块",
  348 + "createTime": 1467116307,
  349 + "forumCode": 10002,
  350 + "comment": 1,
  351 + "id": 62,
  352 + "revieweState": 0,
  353 + "isHot": 0,
  354 + "browse": 0,
  355 + "status": 0
  356 + }
  357 + ],
  358 + "page": 1,
  359 + "pageSize": 2,
  360 + "page_total": 2,
  361 + "total": 3
  362 + },
  363 + "md5": "bb4cf190f2bfdbb32c61fba3ea6c2597",
  364 + "message": "我的帖子"
  365 +}
  366 +```
  367 +
  368 +```json
  369 +{
  370 + "message": "用户ID不能为空",
  371 + "code": 401
  372 +}
  373 +```
  374 +