wiki:appapi/4.6

需求原型: http://trac.pc.com.cn/mobile/pototype/pcauto-club/4.6.0/v1/#p=3_2签到排行榜

1. 车友会提供APP接口4.6

PC端开发环境域名:dev18.pcauto.com.cn

WAP端开发环境域名:dev43.pcauto.com.cn:83/club

PC端线上环境域名:club.pcauto.com.cn

WAP端线上域名:m.pcauto.com.cn/club

1. 签到相关

1.1 车友会签到条目

接口:/appapi/1.0/club/checkinItems.do [GET]
请求参数:
    clubId: 车友会ID [long]

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

返回结果:

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

    totalCheckin: 签到总人数
    checkinList: [
    {
        userId: 用户id
    },
    ...
    ]
}

1.2 车友会签到排行榜

接口:/appapi/1.0/club/checkinRanking.do [GET]
请求参数:
    clubId: 车友会ID [long]
    pageNo: 页码
    pageSize: 页数

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

返回结果:

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

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

    checkinCount: 签到人数

    memberList: [
    {
        userId: 用户id
        nickname: 用户昵称
        totalCheckin: 总签到
        continueCheckin: 连续签到
        checkinAt: 签到时间(格式:HH:mm:SS)
        isCheckin: 是否签到(boolean)
        isVip: 是否认证(boolean)
    }
    ]
}

2. 车友圈相关

2.1 车友圈页--最新帖子

接口:/appapi/1.0/forum/newestTopics.do [GET]
请求参数:
    beforeTime: 取数据时间点(取这个时间点之前的数据),格式:yyyy-MM-dd HH:mm:SS(可不传)
    pageNo: 页码
    pageSize: 页数

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

返回结果:

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

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

    idList: [
    {
        topicId: 帖子id
    }
    ]
}

2.2 车友圈页--精华帖子

接口:/appapi/1.0/forum/pickList.do [GET]
请求参数:
    pageNo: 页码
    pageSize: 页数

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

返回结果:

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

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

    idList: [
    {
        topicId: 帖子id
    }
    ]
}

2.3 车友圈页--动态分享

接口:/appapi/1.0/dyna/doShare.do [POST]
请求参数:
    dynaInfoId: 动态id
    topicId:帖子id(有帖子id就传,没有就为0)
是否登录 :否
缓存时间 : 否
是否分页 : 否

返回结果:

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

2.4 车友圈页--获取帖子分享数

接口:/appapi/1.0/dyna/getdynaShareCount.do [GET]
请求参数:
    dynaInfoId: 动态id,多个使用半角逗号隔开,最少1个,最多100,不存在的动态id,分享数为0

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

返回结果:

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

    shareCountList: [
    {
        dynaInfoId: 动态id
        shareCount: 分享数
    },
    ]
}

2.5 车友圈页--获取帖子分享数(根据帖子Id)

接口:appapi/1.0/dyna/getdynaShareCountByTopicIds.do [GET]
请求参数:
    topicIds: 帖子id,多个使用半角逗号隔开,最少1个,最多100,不存在的帖子id,分享数为0

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

返回结果:

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

    shareCountList: [
    {
        topicId: 动态id
        shareCount: 分享数
    },
    ]
}