Changes between Version 6 and Version 7 of appapi/3.0

Timestamp:

12/05/2014 11:34:05 AM (11 years ago)

Author:

zhouruxuan

Comment:

--

appapi/3.0

@@ -820 +820 @@
 }}}
 
+==== 1.1.20 用户权限获取 ====
+{{{
+说明：用户权限获取
+接口：/appapi/1.0/user/getUserPermission.do [GET]
+请求参数
+        根据用户登录的Session获取用户ID
+
+是否登录:是
+缓存时间:无
+是否分页:否
+
+返回
+{
+        code:
+        message:
+        permissions:[
+                {
+                adminType：权限
+                clubId：车友会id
+                checkIn：是否签到    
+                },
+                {
+                adminType：权限
+                clubId：车友会id
+                checkIn：是否签到    
+                }
+        ]
+}
+
+备注
+adminType说明：
+        -2->当前车友会审核当中 
+        0->普通会员 
+        1->副会长 
+        2->会长
+}}}
+
+==== 1.1.21 获取动态 ====
+{{{
+说明：获取动态
+接口：/appapi/1.0/dyna/getDynaDetail.do [GET]
+请求参数
+        dynaInfoId：动态id
+        createDate：动态创建时间，yyyy-mm-dd格式
+
+是否登录:是
+缓存时间:无
+是否分页:否
+
+返回
+{
+        code:
+        message:
+        dynaDetail:[
+                {
+            postCount:回复数
+            pubTime: 发布时间, 
+            authorId: 作者ID, 
+            forumId: 16160, 
+            authorName: 作者名称, 
+            nickname:作者昵称,
+            contribution: 贡献油值, 
+            dynaInfoId,动态ID
+            authorPhoto: 作者头像, 
+            isRecommend: 是否是推荐,
+            content:动态内容
+            isVip：是否认证  
+            supportCount：点赞数,
+            hasSupport：已赞
+            images:[
+                {
+                url:http://xxxx.jpg,
+                //真实宽度
+                width:960,
+                //真实高度
+                height:1000,
+                //质量参数,默认为0，10月上线
+                qua:80
+                },
+                {
+                url:http://xxxx.jpg,
+                //真实宽度
+                width:960,
+                //真实高度
+                height:1000,
+                //质量参数,默认为0，10月上线
+                qua:80
+                }               
+           ]
+        }
+    ]
+}
+}}}
+
+==== 1.1.22 首页车友会列表接口(游客的推荐） ====
+{{{
+说明：首页车友会列表接口(游客的推荐）
+接口：/appapi/1.0/club/getRecommendClubs.do [GET]
+请求参数
+        *userId:用户ID
+        *provinceId:省份ID
+        cityId:城市ID
+
+是否登录:是
+缓存时间:无
+是否分页:否
+
+返回
+{
+        code:
+        message:
+        recommendClubs:[
+                {
+                clubId:车友会id
+                name:车友会名字
+                logo:会标
+                seriesName:车系名字
+                memberCount：会员数
+                level:星级
+                },
+                {
+                clubId:车友会id
+                name:车友会名字
+                logo:会标
+                seriesName:车系名字
+                memberCount：会员数
+                level:星级
+                }
+                                
+        ]
+}
+}}}
+
+==== 1.1.23 首页车友会列表接口(审核中的车友会列表） ====
+{{{
+说明：首页车友会列表接口(审核中的车友会列表）
+接口：/appapi/1.0/club/getApplyClubs.do [GET]
+请求参数
+        *userId:用户ID
+
+
+是否登录:是
+缓存时间:无
+是否分页:否
+
+返回
+{
+        code:
+        message:
+        applyClubs:[
+                {
+                clubId:车友会id
+                name:车友会名字
+                logo:会标
+                seriesName:车系名字
+                memberCount：会员数
+                level:星级
+                },
+                {
+                clubId:车友会id
+                name:车友会名字
+                logo:会标
+                seriesName:车系名字
+                memberCount：会员数
+                level:星级
+                }
+        ]
+}
+}}}
+
+==== 1.1.24 个人主页动态列表 ====
+{{{
+说明：获取个人动态列表
+接口：/appapi/1.0/dyna/getDynaListByUserId.do [GET]
+请求参数
+        userId:用户ID
+
+
+是否登录:是
+缓存时间:无
+是否分页:否
+
+返回
+{
+        code:
+        message:
+        userId:
+        dynaList:[
+                {
+            postCount:回复数
+            pubTime: 发布时间, 
+            authorId: 作者ID, 
+            forumId: 16160, 
+            authorName: 作者名称, 
+            nickname:作者昵称,
+            contribution: 贡献油值, 
+            dynaInfoId,动态ID
+            authorPhoto: 作者头像, 
+            isRecommend: 是否是推荐,
+            content:动态内容
+            isVip：是否认证  
+            supportCount：点赞数,
+            hasSupport：已赞
+            images:[
+                {
+                url:http://xxxx.jpg,
+                //真实宽度
+                width:960,
+                //真实高度
+                height:1000,
+                //质量参数,默认为0，10月上线
+                qua:80
+                },
+                {
+                url:http://xxxx.jpg,
+                //真实宽度
+                width:960,
+                //真实高度
+                height:1000,
+                //质量参数,默认为0，10月上线
+                qua:80
+                }       
+            ]
+        }
+    ]
+}
+}}}
+
+==== 1.1.25 获取创建车友草稿信息 ====
+{{{
+说明：获取创建车友草稿信息
+接口：/appapi/1.0/club/getCreateClubInfo.do [GET]
+请求参数
+        userId:用户ID
+
+
+是否登录:是
+缓存时间:无
+是否分页:否
+
+返回
+{
+        code:
+        message:
+        userId:
+        clubInfo:[
+                {
+                clubName：车友会名称
+                clubUrl:车友会自定义域名(域名后面一截就行)
+                brandId：品牌ID
+                brandName：品牌名称
+                realName:姓名
+                gender：性别(0:男,1:女)
+                clubAddressCityId：城市ID
+                clubAddressCityName：城市名称
+                clubAddressProvinceId：省ID
+                clubAddressProvinceName：省
+                agree：是否同意
+                phone：联系电话
+                provinceId：省ID
+                provinceName：省名称
+                cityId：城市ID
+                cityName：城市名称
+                seriesId：车系ID
+                seriesName：车系名称
+                introduce：简介
+                postCode:邮编
+                address：地址
+                qqGroup:Q群号
+                themeId:主题类型id，看主题列表接口返回的id
+                appBanner:车友会背景URL
+                type:车友会类型
+                }
+        ]
+}
+}}}
+
+==== 1.1.26 点赞/取消赞 ====
+{{{
+说明：点赞/取消赞 
+接口：/appapi/1.0/dyna/doSupport.do [POST]
+请求参数
+        soupportIds:点赞ID列表（用，连接起来）
+        notSoupportIds:取消赞ID列表（用，连接起来）
+
+
+是否登录:是
+缓存时间:无
+是否分页:否
+
+返回
+{
+        code:
+        message:
+        time:系统完成操作的时间
+}
+}}}
+
+==== 1.1.27 收到的赞列表 ====
+{{{
+说明：收到的赞列表 
+接口：/appapi/1.0/dyna/getSupportList.do [GET]
+请求参数
+        根据用户登录的Session获取用户ID
+
+
+是否登录:是
+缓存时间:无
+是否分页:否
+
+返回
+{
+        code:
+        message:
+        supportList:[
+                {
+                userId：用户id
+                nickName:用户昵称
+                isVip:是否认证用户
+                hadRead：是否已读
+                supportTime：点赞时间，和下面动态创建时间不是一样的
+                //以下部分看设计接口情况是否直接返回动态详情所有
+                dynaType:动态类型
+                dynaInfoId：动态id
+                createDate：动态创建时间（或帖子创建时间），yyyy-mm-dd格式
+                targetId：动态目标id（假设是帖子，返回为帖子id，动态则为动态id，考虑以后可能活动相册都是动态，命名为targetId，）
+                content：内容
+                image：图片
+                },
+                {
+                userId：用户id
+                nickName:用户昵称
+                isVip:是否认证用户
+                hadRead：是否已读
+                supportTime：点赞时间，和下面动态创建时间不是一样的
+                //以下部分看设计接口情况是否直接返回动态详情所有
+                dynaType:动态类型
+                dynaInfoId：动态id
+                createDate：动态创建时间（或帖子创建时间），yyyy-mm-dd格式
+                targetId：动态目标id（假设是帖子，返回为帖子id，动态则为动态id，考虑以后可能活动相册都是动态，命名为targetId，）
+                content：内容
+                image：图片
+                }
+        ]
+}
+}}}
+
+==== 1.1.28 未读点赞清零 ====
+{{{
+说明：未读点赞清零
+接口：/appapi/1.0/dyna/clearUnreadSupports.do [POST]
+请求参数
+        根据用户登录的Session获取用户ID
+
+
+是否登录:是
+缓存时间:无
+是否分页:否
+
+返回
+{
+        code:
+        message:
+}
+}}}
+
+==== 1.1.29 获取动态点赞用户列表 ====
+{{{
+说明：获取动态点赞用户列表
+接口：/appapi/1.0/dyna/getSupportUserList.do [GET]
+请求参数
+        dynaInfoId：动态id
+
+
+是否登录:否
+缓存时间:无
+是否分页:否
+
+返回
+{
+        code:
+        message:
+        userList:[
+                {
+                userId:用户id
+                nickName:昵称
+                },
+                {
+                userId:用户id
+                nickName:昵称
+                }
+        ]
+}
+}}}
+
+==== 1.1.30 获取动态列表（返回3张图片） ====
+{{{
+说明：获取动态列表（返回3张图片）
+接口：/appapi/1.0/dyna/getDynaList3Pictrues.do [GET]
+请求参数
+        clubId:车友会id
+
+
+是否登录:否
+缓存时间:无
+是否分页:是
+
+返回
+{
+        code:
+        message:
+        dynaList:[
+                {
+            postCount:回复数
+            pubTime: 发布时间, 
+            topicTitle: 帖子标题, 
+            forumName: 板块名称, 
+            isPick: 是否是精华, 
+            authorId: 作者ID, 
+            isHasImg: 是否有图片, 
+            image1: 第一张图,
+                        image2: 第二张图, 
+            image3: 第三张图,                       
+            forumId: 16160, 
+            authorName: 作者名称, 
+            nickname:作者昵称,
+            contribution: 贡献油值, 
+            topicId: 帖子ID, 
+            authorPhoto: 作者头像, 
+            isRecommend: 是否是推荐,
+            isVip：是否认证
+            dynaInfoId：动态id
+            supportCount：点赞数,
+            hasSupport：已赞
+                }
+        ]
+}
+}}}
+
+==== 1.1.31 获取动态列表（返回动态图片列表） ====
+{{{
+说明：获取动态列表（返回动态图片列表）
+接口：/appapi/1.0/dyna/getDynaListImages.do [GET]
+请求参数
+        clubId:车友会id
+
+
+是否登录:否
+缓存时间:无
+是否分页:是
+
+返回
+{
+        code:
+        message:
+        dynaList:[
+                {
+            postCount:回复数
+            pubTime: 发布时间, 
+            topicTitle: 帖子标题, 
+            forumName: 板块名称, 
+            isPick: 是否是精华, 
+            authorId: 作者ID, 
+            isHasImg: 是否有图片, 
+            forumId: 16160, 
+            authorName: 作者名称, 
+            nickname:作者昵称,
+            contribution: 贡献油值, 
+            topicId: 帖子ID, 
+            authorPhoto: 作者头像, 
+            isRecommend: 是否是推荐,
+            isVip：是否认证
+            dynaInfoId：动态id
+            supportCount：点赞数,
+            hasSupport：已赞(根据当前登录的用户是否赞过此动态）
+            images:[
+                {
+                url:http://xxxx.jpg,
+                //真实宽度
+                width:960,
+                //真实高度
+                height:1000
+                },
+                {
+                url:http://xxxx.jpg,
+                //真实宽度
+                width:960,
+                //真实高度
+                height:1000
+                }
+             ]
+        }
+     ]
+}
+}}}
 
 {{{