版块首页相关接口.md 8.87 KB

Raw Blame History Permalink



1、获取版块的头信息

获取版块的头信息（method=app.social.getForumHeadInfo）


公共请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


client_secret
string
50
否
5ac68f20cb18efe154be

进入接口提供的参数加密信息


app_version
float
10
否
1

APP版本


os_version
string
20
否
Android4.4

系统版本+机器型号


client_type
string
20
否
iphone/android/ipad

手机型号（不区分大小写）


screen_size
string
20
否
800x900

（手机尺寸）


请求参数

无

注意，通用的头部没有列出。

请求示例
http://192.168.102.205:8080/gateway?method=app.social.getForumHeadInfo&forumCode=10001


响应

code为200即为成功，否则是失败。 
响应JSON格式如下所示:

{
    "alg": "SALT_MD5",
    "code": 200,
    "data": {
        "commentsNum": 1,
        "forumCode": 10001,
        "forumDesc": "版块1的说明",
        "forumName": "版块1",
        "forumPic": "http://img12.static.yhbimg.com/goodsimg/2016/06/06/05/02e8b4a63c0101b1a1a8f04b53d817b9d4.png",
        "orderBy": 1,
        "postsNum": 1,
        "praiseNum": 1
    },
    "md5": "7ec8fb7fc05751e7840fc306cb65135e",
    "message": "版块头信息获取成功."
}


2、板块最新帖子列表

最新帖子（method=app.social.getNewPostList）


公共请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


client_secret
string
50
否
5ac68f20cb18efe154be

进入接口提供的参数加密信息


app_version
float
10
否
1

APP版本


os_version
string
20
否
Android4.4

系统版本+机器型号


client_type
string
20
否
iphone/android/ipad

手机型号（不区分大小写）


screen_size
string
20
否
800x900

（手机尺寸）


请求参数


参数名称
参数类型
可否为空
示例
默认值
备注


forumCode
String
否
10004
0
版块code


page
int
是
1
1
页码


limit
int
是
5
10
每页多少条


注意，通用的头部没有列出。

请求示例
http://192.168.102.205:8080/gateway/?method=app.social.getNewPostList&forumCode=10004&page=1&limit=2&debug=XYZ


响应

code为200即为成功，否则是失败。 
响应JSON格式如下所示:

{
    "alg": "SALT_MD5",
    "code": 200,
    "data": {
        "list": [
            {
                "isIndexTop": 1,
                "blocks": [
                    {
                        "contentData": "啊啊啊啊啊啊啊哈哈哈",
                        "templateKey": "text",
                        "order": 1
                    },
                    {
                        "contentData": "http://img12.static.yhbimg.com/goodsimg/2016/06/06/05/02e8b4a63c0101b1a1a8f04b53d817b9d4.png",
                        "templateKey": "image",
                        "order": 2
                    },
                    {
                        "contentData": "http://img12.static.yhbimg.com/goodsimg/2016/06/06/05/02e8b4a63c0101b1a1a8f04b53d817b9d5.png",
                        "templateKey": "image",
                        "order": 3
                    }
                ],
                "updateTime": 0,
                "praise": 0,
                "revieweTime": 0,
                "isForumTop": 0,
                "createTime": 1467116718,
                "forumCode": 10004,
                "comment": 1,
                "id": 78,
                "revieweState": 0,
                "isHot": 0,
                "browse": 0,
                "status": 0
            },
            {
                "isIndexTop": 0,
                "blocks": [
                    {
                        "contentData": "啊啊啊啊啊啊SDDDDDDD哈",
                        "templateKey": "text",
                        "order": 1
                    },
                    {
                        "contentData": "http://img12.static.yhbimg.com/goodsimg/2016/06/06/05/02e8b4a63c0101b1a1a8f04b53d817b9d4.png",
                        "templateKey": "image",
                        "order": 2
                    },
                    {
                        "contentData": "http://img12.static.yhbimg.com/goodsimg/2016/06/06/05/02e8b4a63c0101b1a1a8f04b53d817b9d5.png",
                        "templateKey": "image",
                        "order": 3
                    }
                ],
                "updateTime": 0,
                "praise": 0,
                "revieweTime": 0,
                "isForumTop": 0,
                "createTime": 1467116713,
                "forumCode": 10004,
                "comment": 1,
                "id": 76,
                "revieweState": 0,
                "isHot": 1,
                "browse": 0,
                "status": 0
            }
        ],
        "page": 1,
        "pageSize": 2,
        "page_total": 3,
        "total": 5
    },
    "md5": "4dc5fd43476f025dfeaabc93ca4894ed",
    "message": "板块最新帖子"
}


{
    "message": "请选择版块",
    "code": 403
}


3、板块最热帖子列表

最新帖子（method=app.social.getHotPostList）


公共请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


client_secret
string
50
否
5ac68f20cb18efe154be

进入接口提供的参数加密信息


app_version
float
10
否
1

APP版本


os_version
string
20
否
Android4.4

系统版本+机器型号


client_type
string
20
否
iphone/android/ipad

手机型号（不区分大小写）


screen_size
string
20
否
800x900

（手机尺寸）


请求参数


参数名称
参数类型
可否为空
示例
默认值
备注


forumCode
String
否
10004
0
版块code


page
int
是
1
1
页码


limit
int
是
5
10
每页多少条


注意，通用的头部没有列出。

请求示例
http://192.168.102.205:8080/gateway/?method=app.social.getHotPostList&forumCode=10004&page=1&limit=2&debug=XYZ


响应

code为200即为成功，否则是失败。 
响应JSON格式如下所示:

{
    "alg": "SALT_MD5",
    "code": 200,
    "data": {
        "list": [
            {
                "isIndexTop": 0,
                "blocks": [
                    {
                        "contentData": "啊啊啊啊啊啊SDDDDDDD哈",
                        "templateKey": "text",
                        "order": 1
                    },
                    {
                        "contentData": "http://img12.static.yhbimg.com/goodsimg/2016/06/06/05/02e8b4a63c0101b1a1a8f04b53d817b9d4.png",
                        "templateKey": "image",
                        "order": 2
                    },
                    {
                        "contentData": "http://img12.static.yhbimg.com/goodsimg/2016/06/06/05/02e8b4a63c0101b1a1a8f04b53d817b9d5.png",
                        "templateKey": "image",
                        "order": 3
                    }
                ],
                "updateTime": 0,
                "praise": 0,
                "revieweTime": 0,
                "isForumTop": 0,
                "createTime": 1467116713,
                "forumCode": 10004,
                "comment": 1,
                "id": 76,
                "revieweState": 0,
                "isHot": 1,
                "browse": 0,
                "status": 0
            },
            {
                "isIndexTop": 0,
                "blocks": [
                    {
                        "contentData": "啊啊啊啊啊啊啊啊哈哈哈",
                        "templateKey": "text",
                        "order": 1
                    },
                    {
                        "contentData": "http://img12.static.yhbimg.com/goodsimg/2016/06/06/05/02e8b4a63c0101b1a1a8f04b53d817b9d4.png",
                        "templateKey": "image",
                        "order": 2
                    },
                    {
                        "contentData": "http://img12.static.yhbimg.com/goodsimg/2016/06/06/05/02e8b4a63c0101b1a1a8f04b53d817b9d5.png",
                        "templateKey": "image",
                        "order": 3
                    }
                ],
                "updateTime": 0,
                "praise": 0,
                "revieweTime": 0,
                "isForumTop": 0,
                "createTime": 1467116660,
                "forumCode": 10004,
                "comment": 1,
                "id": 74,
                "revieweState": 0,
                "isHot": 1,
                "browse": 0,
                "status": 0
            }
        ],
        "page": 1,
        "pageSize": 2,
        "page_total": 2,
        "total": 4
    },
    "md5": "65d638d5cc363af7aa068e8e0c9f757a",
    "message": "板块最热帖子"
}


{
    "message": "请选择版块",
    "code": 403
}