wiki:appapi/4.2

Version 5 (modified by zhouruxuan, 11 years ago) (diff)

--

1. 车友会提供APP接口4.2(车友圈)

1.1 车友会相关接口

1.1.1 绑定车友圈

接口/appapi/1.0/forum/bundUserForum.do [POST]
说明 : 绑定车友圈
请求参数 :
  forumId:版块ID
  forumName:版块名字


是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

1.1.2 解绑车友圈

接口/appapi/1.0/forum/unBundUserForum.do [POST]
说明 : 解绑车友圈
请求参数 :
  forumId:版块ID


是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

1.1.3 获取用户绑定车友圈列表

接口/appapi/1.0/forum/listForumsByUserId.do [GET]
说明 : 获取用户绑定车友圈列表
请求参数 :



是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
   userId:用户ID
   forumList:[
      {
         forumId:版块ID
         forumName:版块名字
      }
   ]

   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

1.1.4 判断用户是否绑定某车友圈

接口/appapi/1.0/forum/isBound.do [GET]
说明 : 判断用户是否绑定某车友圈
请求参数 :

   userId:用户ID
   forumId:版块ID

是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果:
{
   userId:用户ID
   forumId:版块ID
   isBound:是否绑定(0:未绑定;1:已绑定)

   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

1.1.5 获取主题对应的动态ID

接口/appapi/1.0/forum/getDynaByTopicId.do [GET]
说明 : 获取主题对应的动态ID
请求参数 :

   topicId:主题ID
   createDate:主题创建时间(yyyy-MM-dd hh:mm:ss)

是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果:
{
   topicId:主题ID
   createDate:主题创建日期
   dynaInfoId:动态ID


   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

1.1.7 获取同城动态列表

说明:获取同城动态列表
接口:/appapi/3.0/dyna/getTongChengDynaList.do [GET]
请求参数:
      *provinceId 发动态省地区id(必选)
      cityId 发动态市地区id(无则不传)

是否登录:否
缓存时间:无
是否分页:是


返回
{

	dynaList:[
	    {
	        dynaInfoId:动态id,
		postCount:回复数
		pubTime: 发布时间, 
		createBy: 创建者ID, 
		nickName:作者昵称,
		isHasImg: 是否有图片(0:没有,1:有), 
		petrol: 贡献油值, 
		authorPhoto: 作者头像, 
		isVip:是否认证,(0:否,1:是)
		praiseCount:点赞数

		dynaType:动态类型(1-普通帖子(旧数据包含提问帖子),2-说说动态,3-图片动态,4-提问帖子,5-公告动态,6-活动动态,7-新会员加入动态,8-创建车友会动态)
				
		//以上是动态列表公共字段
		//下面是根据不同的动态类型,返回不同的字段或内容
		dynaType == 1,4
		         dynaTargetId:帖子ID
		         content:帖子内容 
		         topicTitle: 帖子标题,
		         isPick: 是否是精华(0:不是,1:是,2:是), 
		         isRecommend: 是否是推荐(0:不是,1:是),
                         forumId: 板块ID, 
		         forumName: 板块名称, 
                         forumUrl:板块URL
                         

				   
		dynaType == 2
			 dynaTargetId :说说动态ID
			 content:说说内容
                         clubName:车友会名字
                         clubUrl:车友会URL
				   
					   
				   
		images:[
		     {
			url:http://xxxx.jpg,
			//真实宽度
			width:960,
			//真实高度
			height:1000
		      },
                     {
			url:http://xxxx.jpg,
			//真实宽度
			width:960,
			//真实高度
			height:1000
		      }
	        ]
	   }
     ]

        total:总条数
        pageNo:页码
        pageSize:每页条数
        pageCount:总共几页

	code:0成功,-1失败
        message:提示信息
        version: 接口版本号如1.0,1.0(latest)表示最新版本
        
}

1.2 论坛相关接口

1.2.1 推荐车友圈

接口/appapi/1.0/forum/bundUserForum.do [GET]
说明 : 推荐车友圈
请求参数 :



是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果:
{
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

1.2.2 车友圈信息

接口/appapi/1.0/forum/bundUserForum.do [GET]
说明 : 车友圈信息
请求参数 :



是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果:
{
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

1.2.3 车友圈主题列表

接口/appapi/1.0/forum/bundUserForum.do [GET]
说明 : 车友圈主题列表 
请求参数 :



是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果:
{
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

1.2.4 车友圈置顶主题列表

接口/appapi/1.0/forum/bundUserForum.do [GET]
说明 : 车友圈置顶主题列表 
请求参数 :



是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果:
{
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

1.2.4 车友圈置顶主题列表

接口/appapi/1.0/forum/bundUserForum.do [GET]
说明 : 车友圈置顶主题列表 
请求参数 :



是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果:
{
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

1.2.5 主题终端

接口/appapi/1.0/forum/bundUserForum.do [GET]
说明 : 主题终端 
请求参数 :



是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果:
{
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

1.2.6 主题跟帖列表

接口/appapi/1.0/forum/bundUserForum.do [GET]
说明 : 主题跟帖列表
请求参数 :



是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果:
{
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

1.2.7 主题图片表

接口/appapi/1.0/forum/bundUserForum.do [GET]
说明 : 主题图片表
请求参数 :



是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果:
{
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}
返回
顶部