wiki:pcauto_club_1.2.0/api

Version 37 (modified by xieweijie, 12 years ago) (diff)

4.1车友动态接口 参数修改

所有接口文档  http://trac.pc.com.cn/iphone/wiki/pcauto_club_2.0.0/api

2.5车友动态接口

接口URL:/topic/listTopicByClubId.do
说明:根据车友会ID,返回车友动态列表

请求参数:
clubId:车友会ID
imagesType:1//图片返回形式,1.2.0需求修改,兼容旧版本,加参数判断,为1时返回参数增加下面这个字段,里面是数组,旧的image1 image2 image3字段的无须返回,不传或其他情况需要返回该3个字段

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

返回结果:
{
    "clubId": clubId, 
    "data": [
             {
             "postCount":回复数
	     "pubTime": 发布时间, 
            "topicTitle": 帖子标题, 
            "forumName": 板块名称, 
            "isPick": 是否是精华, 
            "authorId": 作者ID, 
            "isHasImg": 是否有图片, 
            "image2": 第二张图, 
            "image1": 第一张图, 
            "forumId": 16160, 
            "authorName": 作者名称, 
            "nickname":作者昵称,
            "contribution": 贡献油值, 
            "topicId": 帖子ID, 
            "authorPhoto": 作者头像, 
            "image3": 第三张图, 
            "isRecommend": 是否是推荐,
            "images":[
		{
			“url”:http://xxxx.jpg,
			//真实宽度
			“width”:960,
			//真实高度
			“height”:1000
		},
                {
			“url”:http://xxxx.jpg,
			//真实宽度
			“width”:960,
			//真实高度
			“height”:1000
		}
	        ]
           }
	]
}

2.6车友会相册列表接口

接口URL:/album/getAlbumByClubId.do
说明:根据车友会ID,返回相册列表

请求参数:
clubId:车友会ID
userId (可选参数)

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

返回结果:
{
    "clubId": 车友会ID, 
    "clubName": 相册名称,
    “adminType”:成员角色//说明参考2.2
    "data": [
            {
            "photos":[
                {
                "urlsmall":"http://dev2.pconline.com.cn:9191/autoclub/1403/27/c0/1195694_1395912475624_160x120.jpg",
                "urlbig":"http://dev2.pconline.com.cn:9191/autoclub/1403/27/c0/1195694_1395912475624_700.jpg"
                }],
            "albumName":"默认相册",
            "albumId":171,
            "photoSize": 相片数,
            "coverurlsmall":"http://dev2.pconline.com.cn:9191/autoclub/1403/27/c0/1195694_1395912475624_160x120.jpg",//封面图片
            }
    ]
}

2.43 推送设置接口

    url:/interface/club/do_autoClubUserApp.jsp
    参数:
     userId://用户id,登出则不传本参数
     token://设备token
     ids:  //1,0,1 字符串,顺序表示帖子回复,私信,系统通知,1为打开,0为关闭
     beginTime:(如果勿扰模式关闭了,就不传此字段)02:00传02 23:00传23
     endTime:(如果勿扰模式关闭了,就不传此字段)02:00传02 23:00传23
     open: (1发推送,0不发推送)
     sound:(1为有声音,0为无)
     shake:(1为有振动,0为无)
    请求方法:post
    是否需要登录:是
    返回参数:
    {
      "description":"token或者ids为空",//错误详情
      "status":0;   (0:成功
                          -1:ids不正确或者日期格式不正确  
                          -2:token为空或者ids为空
                          -3:提交方式不对,请改用Post提交
                          -4:设置失败)
    }
     

3.1 IM获取token

    请求url:/club/getToken.do,
    HTTP请求方式:POST,
    是否需要登录:true,
    返回格式:json,
    返缓存方式:无,
    缓存时间:无,
    请求参数:
           userId://太平洋帐号id,
           grabber: //是否需要强制获取新的Token,0:不需要,1:需要
    说明:
    返回结果:
{
           "token":"P0JtJ0LBGI9Qya1+uIPR0dLyEN9NFQAM0jQTPx8aQUQg5RfoaakM54il9pxVp1TGrpEVXynHbxxfokmJy1QkcQ==",
           "code":0,
           "msg":"成功获取token!"
}
token 获取融云Token
message 返回结果描述
code 返回结果代码,1:非登录用户,2:不是车友会成员,
 3:获取Token导演,0:操作成功

3.2 IM获取好友列表

    请求url:/club/getFriendList.do,
    HTTP请求方式:POST,
    是否需要登录:true,
    返回格式:json,
    返缓存方式:无,
    缓存时间:无,
    请求参数:clubId://车友会id,,
    说明:
    返回结果:
{
code:0 //code 返回结果代码,1:车友会没有通过审核,0:操作成功
message://返回结果描述
friendList:[
     {
         userId://太平洋帐号id
         userName://昵称
         faceUrl://头像url
      }
     ],
image:http://xxxxx 群组头像
}

4.1车友动态接口(替代接口2.5,兼容旧版本,接口必须重新开)

接口URL:/dyna/getDynaList.do
说明:根据车友会ID,返回车友动态列表
请求参数:
clubId:车友会ID(二选一)
userId:用户Id(二选一)
type:筛选 1帖子(不全,只返回车友会对应用户帖子),2动态 , 默认0全部
是否登录:否
缓存时间:无
是否分页:是

返回结果:
{
    "clubId": clubId, (二选一)
    "userId": userId, (二选一)
    "data": [
             {
             "postCount":回复数
	     "pubTime": 发布时间, 
            "topicTitle": 帖子标题, 
            "forumName": 板块名称, 
            "isPick": 是否是精华, 
	    "isPost": 是否帖子, 
            "authorId": 作者ID, 
            "forumId": 16160, 
            "authorName": 作者名称, 
            "nickname":作者昵称,
            "contribution": 贡献油值, 
            "topicId": 帖子ID,
            "dynaInfoId",动态ID
            "authorPhoto": 作者头像, 
            "isRecommend": 是否是推荐,
            “content”:动态内容
            "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
		}
	        ]
           }
	]
}

4.2 发动态

    请求url:/dyna/createCommentDyna.do,
    HTTP请求方式:POST,
    是否需要登录:true,
    返回格式:json,
    返缓存方式:无,
    缓存时间:无,
    请求参数:
        clubId 车友会ID
        content 留言内容
        images:[
               {
                    url:"http://xxxxx",
                    width:100 //宽
                    height:200 //高
               },
               {
                    url:"http://xxxxx",
                    width:100 //宽
                    height:200 //高
               }
         ]//图片
    说明:
    图片上传指令 command:53003 53004 53016 53017 53018 53019 53020
    返回结果:{
	code:0			//错误代码,0:正常返回 1:操作失败 1001:权限类错误 1002:数据类错误 1003:用户无登陆
	message: “您还没有登陆”		//错误提示
}

4.3修改个人信息

    请求url:http://my.pcauto.com.cn/intf/updateUser.jsp,
    HTTP请求方式:POST,
    是否需要登录:true,
    返回格式:json,
    返缓存方式:无,
    缓存时间:无,
    请求参数:
       domicileId;城市ID
       nickName:昵称
       telephone;电话号码
       realName;真实姓名
       address;地址
       msn;msn账号
       qq;qq账号
       zip;邮编
       birthday;出生日期 //格式YYYY-MM-DD
       gender   1>男  2女  0 未知
    返回结果:{
	code:0			//错误代码,0:正常返回
	message: “您还没有登陆”		//错误提示
}

4.4 回复动态

    请求URL:/dyna/replyDyna.do
    HTTP请求方式:POST,
    是否需要登录:true,
    返回格式:json,
    返缓存方式:无,
    缓存时间:无
    请求参数:
       clubId 车友会ID
       content 留言内容
       dynaInfoId 动态ID
       postToDynaReplyId 发表回复的回复ID
       createDate 创建时间,列表数据的pubTime,后台查表需要,格式yyyy-MM-dd
    返回结果:
{
         code	返回结果代码,正常返回 1:操作失败 1001:权限类错误 1002:数据类错误 1003:用户无登陆  
         message	返回结果描述
         data:{
                    replyId://回复id
                    userId://用户ID
                    authorPhoto://用户头像
                    nickname://用户昵称
                    content://回复内容
                    createDate://回复时间
                    postToDynaReplyId://被回复id(为回复回复时返回)
                    postToUserId://被回复用户ID(为回复回复时返回)
                    postToNickName://被回复用户昵称(为回复回复时返回)
              }
}

4.5 动态回复列表

    请求URL: /dyna/getReplyList.do
    HTTP请求方式:POST,
    是否需要登录:false,
    返回格式:json,
    返缓存方式:无,
    缓存时间:无,
    是否分页:是
    请求参数:
        dynaInfoId 动态ID
        createDate 创建时间,列表数据的pubTime,后台查表需要
    返回结果:
 {
       dynaInfoId://动态ID
       resultList:[
              {
                    replyId://回复id
                    userId://用户ID
                    authorPhoto://用户头像
                    nickname://用户昵称
                    content://回复内容
                    createDate://回复时间
                    postToDynaReplyId://被回复id(为回复回复时返回)
                    postToUserId://被回复用户ID(为回复回复时返回)
                    postToNickName://被回复用户昵称(为回复回复时返回)
              }
       ]
}

4.5个人中心帖子列表

接口URL:
bbs.pcauto.com.cn/plugins/autoclub/user/topics.do
说明:根据用户id返回所有帖子列表
是否分页:是
请求参数:
userId: 用户ID
imgSize: 需要图片数,默认为3张
audited: 是否审核通过,默认为true
maxLength: 帖子内容长度,默认为240
resp_enc: 编码,默认为UTF-8
返回
与4.1一致