ucapi/1.0 – Trac

Context Navigation

Version 4 (modified by zhouruxuan, 11 years ago) (diff)
--

接口索引

1. 1. 车友会提供个人中心接口
  1. 1.1 动态相关

1. 车友会提供个人中心接口

1.1 动态相关

1.1.1 个人主页动态列表

说明：获取个人动态列表
接口：/usercenter/1.0/dyna/getDynaListByUserId.do [GET]
请求参数
	*userId:用户ID


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

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

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

	userId:
	dynaList:[
	    {
	        dynaInfoId：动态id，
		postCount:回复数
		pubTime: 发布时间, 
		forumId: 板块ID, 
		forumName: 板块名称, 
		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：是）
				   
		dynaType == 2
			 dynaTargetId ：说说动态ID
			 content:说说内容
				   
		dynaType == 3
			 dynaTargetId ：相册ID
		         content:上传了100张相片到《相册名字》
				   
		dynaType == 5
                         content : 发布了公告：XXXXXXXXXXXX
				   
		dynaType == 6
			 dynaTargetId ：活动ID
			 content:发起了活动：活动标题
                         signUpCount:成功报名人数
                         activityCost:每人花费	
                         activityCover : 活动封面图
                 
                dynaType == 7
                         content : Hello，我已经加入了 + 车友会名字 + ，现在我是一个有组织的人了，欢迎大家来围观	
                 
                dynaType == 8 
                         content : 创建了+ clubName + 车友会主页： + targetUrl + , 大家快去邀请车友加入吧	

                dynaType == 9	
                        dynaTargetId: 动态ID
                        content : 投票标题
                        voteCount: 投票人数				   
				   
		images:[
		     {
			url:http://xxxx.jpg,
			//真实宽度
			width:960,
			//真实高度
			height:1000
		      },
                     {
			url:http://xxxx.jpg,
			//真实宽度
			width:960,
			//真实高度
			height:1000
		      }
	        ]
	   }
     ]
}

1.2.2 动态详情接口

说明：获取动态
接口：/usercenter/1.0/dyna/getDynaDetail.do [GET]
请求参数
	*dynaInfoId：动态id
	*createBy：动态创建者id

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

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

	dynaDetail:[
		{
	    postCount:回复数
	    pubTime: 发布时间, 
            authorId: 作者ID, 
            forumId: 16160, 
            authorName: 作者名称, 
            nickname:作者昵称,
            contribution: 贡献油值, 
            dynaInfoId,动态ID
            authorPhoto: 作者头像, 
            isRecommend: 是否是推荐,
            content:动态内容
	    isVip：是否认证	(0:未认证,1:已认证)
	    praiseCount：点赞数,
            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.3 点赞/取消赞

说明：点赞/取消赞 
接口：/appapi/1.0/dyna/doPraise.do [POST]
请求参数
	praiseDynaInfoIds:动态ID,动态创建日期（Json形式）
	unPraiseDynaInfoIds:动态ID,动态创建日期（Json形式）

        Json形式例子：
        {
         praiseDynaInfoIds:[
           {"dynaInfoId":"111","createDate":"2014-11-01"},
           {"dynaInfoId":"111","createDate":"2014-11-01"},
           {"dynaInfoId":"111","createDate":"2014-11-01"}
         ],
         unPraiseDynaInfoIds:[
           {"dynaInfoId":"111","createDate":"2014-11-01"},
           {"dynaInfoId":"111","createDate":"2014-11-01"},
           {"dynaInfoId":"111","createDate":"2014-11-01"}
         ]
        }



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

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

	time:系统完成操作的时间
        failPraiseDynaInfoIds:返回设置点赞失败的动态ID(类似参数列表,Json格式）
        failUnPraiseDynaInfoIds:返回取消赞失败的动态ID(类似参数列表,Json格式）

        返回的动态ID列表说明：
        failPraiseDynaInfoIds：[
           {"dynaInfoId":"111","createDate":"2014-11-01"},
           {"dynaInfoId":"111","createDate":"2014-11-01"}
        ]
        failUnPraiseDynaInfoIds：[
           {"dynaInfoId":"111","createDate":"2014-11-01"},
           {"dynaInfoId":"111","createDate":"2014-11-01"}
        ]
}

1.1.4 获取动态点赞用户列表

说明：获取动态点赞用户列表
接口：/appapi/1.0/dyna/getPraiseUserList.do [GET]
请求参数
	*dynaInfoId：动态id
        pageNo:页码数
        pageSize:每页条数


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

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

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

	userList:[
		{
		userId:用户id
		nickName:昵称
		},
		{
		userId:用户id
		nickName:昵称
		}
	]
}

1.1.5 判断是否已赞

说明：判断是否已赞
接口：/appapi/1.0/dyna/getHadPraiseList.do [GET]
请求参数
        *userId:用户ID
	*dynaInfoIds：动态id列表，用“，”连接起来


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

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

	hadPraiseList:[123,456,789,0]  返回已经赞过的动态ID数组，没有返回空数组
}

返回
顶部

Download in other formats:

Plain Text