wiki:appapi/1.0
Last modified 10 years ago

接口索引

    1. 1. 车友会任务接口1.0
      1. 1. 车友会任务接口1.0
        1. 1.1. app使用 任务列表接口1.0
        2. 1.2. 临时供wap使用 任务列表接口1.0
        3. 1.3. 任务列表接口1.0
        4. 1.4. 用户任务状态接口1.0
        5. 1.5. 获取当前登录用户信息接口1.0
        6. 1.6. 根据uid获取用户信息接口1.0
        7. 1.7. 兑换接口1.0
        8. 1.8. 取消兑换接口1.0
        9. 1.9. 更新用户金币数接口1.0
        10. 2.0. 邀请排行榜接口1.0

1. 车友会任务接口1.0

备注： 任务系统相关接口，开发环境域名： http://dev38.pcauto.com.cn:8085/； 线上正式环境域名： http://task.pcauto.com.cn

1. 车友会任务接口1.0

1.1. app使用 任务列表接口1.0

接口/intf/clubgc/app/taskList.do [get]
请求参数 ：无

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

返回结果：
{
	disposableTask: [ {
               appAction: {
                   action: 动作,
                   desc: 动作描述
               },
               application: 应用,
               applogo: app的logo链接,
               current: 当前完成的次数,
               gold: 奖励金币,
               limitDaily: 每天最大次数,
               limitPermanantly: 永久次数,
               pcaAction: {
                  action: 动作,
                  desc: 动作描述
               },
               pclogo: 在pc的logo链接,
               received: 是否领取了奖励,
               status: 状态,
               taskId: 任务id,
               taskName: 任务名称,
               taskType: 任务类型,
               wapAction: {
                   desc: 描述,
                   text: 文本,
                   url: 链接
                   }
               },

           ]，
         normalTasks: [ { 
               appAction: {
                   action: 动作,
                   desc: 动作描述
               },
               application: 应用,
               applogo: app的logo链接,
               current: 当前完成的次数,
               gold: 奖励金币,
               limitDaily: 每天最大次数,
               limitPermanantly: 永久次数,
               pcaAction: {
                  action: 动作,
                  desc: 动作描述
               },
               pclogo: 在pc的logo链接,
               received: 是否领取了奖励,
               status: 状态,
               taskId: 任务id,
               taskName: 任务名称,
               taskType: 任务类型,
               wapAction: {
                   desc: 描述,
                   text: 文本,
                   url: 链接
                   }
               },

           ]
}

1.2. 临时供wap使用 任务列表接口1.0

接口/intf/clubgc/temp/taskList.do [get]
请求参数 ：无

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

返回结果：
{
	disposableTask: [ { 
               appAction: {
                   action: 动作,
                   desc: 动作描述
               },
               application: 应用,
               applogo: app的logo链接,
               current: 当前完成的次数,
               gold: 奖励金币,
               limitDaily: 每天最大次数,
               limitPermanantly: 永久次数,
               pcaAction: {
                  action: 动作,
                  desc: 动作描述
               },
               pclogo: 在pc的logo链接,
               received: 是否领取了奖励,
               status: 状态,
               taskId: 任务id,
               taskName: 任务名称,
               taskType: 任务类型,
               wapAction: {
                   desc: 描述,
                   text: 文本,
                   url: 链接
                   }
               },

           ]，
         normalTasks: [ { 日常任务
               appAction: {
                   action: 动作,
                   desc: 动作描述
               },
               application: 应用,
               applogo: app的logo链接,
               current: 当前完成的次数,
               gold: 奖励金币,
               limitDaily: 每天最大次数,
               limitPermanantly: 永久次数,
               pcaAction: {
                  action: 动作,
                  desc: 动作描述
               },
               pclogo: 在pc的logo链接,
               received: 是否领取了奖励,
               status: 状态,
               taskId: 任务id,
               taskName: 任务名称,
               taskType: 任务类型,
               wapAction: {
                   desc: 描述,
                   text: 文本,
                   url: 链接
                   }
               },

           ]
}

1.3. 任务列表接口1.0

接口/intf/clubgc/temp/taskList.do [get]
请求参数 ：无

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

返回结果：
{
	disposableTask: [ { 
               appAction: {
                   action: 动作,
                   desc: 动作描述
               },
               application: 应用,
               applogo: app的logo链接,
               current: 当前完成的次数,
               gold: 奖励金币,
               limitDaily: 每天最大次数,
               limitPermanantly: 永久次数,
               pcaAction: {
                  action: 动作,
                  desc: 动作描述
               },
               pclogo: 在pc的logo链接,
               received: 是否领取了奖励,
               status: 状态,
               taskId: 任务id,
               taskName: 任务名称,
               taskType: 任务类型,
               wapAction: {
                   desc: 描述,
                   text: 文本,
                   url: 链接
                   }
               },

           ]，
         normalTasks: [ { 日常任务
               appAction: {
                   action: 动作,
                   desc: 动作描述
               },
               application: 应用,
               applogo: app的logo链接,
               current: 当前完成的次数,
               gold: 奖励金币,
               limitDaily: 每天最大次数,
               limitPermanantly: 永久次数,
               pcaAction: {
                  action: 动作,
                  desc: 动作描述
               },
               pclogo: 在pc的logo链接,
               received: 是否领取了奖励,
               status: 状态,
               taskId: 任务id,
               taskName: 任务名称,
               taskType: 任务类型,
               wapAction: {
                   desc: 描述,
                   text: 文本,
                   url: 链接
                   }
               },

           ]
}

1.4. 用户任务状态接口1.0

接口/intf/clubgc/taskProgress.do [get]
请求参数 ：无

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

返回结果：
{
	 [ {
             current:当前完成的次数,
             received: 是否领取了奖励,
             status: 任务状态,
             taskId: 任务id
           }
           
         ]
}

1.5. 获取当前登录用户信息接口1.0

接口/intf/clubgc/getUserInfo.do [get]
请求参数 ：无

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

返回结果：
{
	  {
             goldCount: 用户现有金币数,
             status: 状态,
             userId: 用户id,
             userName:用户昵称
           }
           
         
}

1.6. 根据uid获取用户信息接口1.0

接口/intf/clubgc/getUserInfoById.do [get]
请求参数 ：uid

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

返回结果：
{
	  {
             goldCount: 用户现有金币数,
             status: 状态,
             userId: 用户id,
             userName:用户昵称
           }
           
         
}

1.7. 兑换接口1.0

接口/intf/clubgc/exchangeReward.do [post]
请求参数 ：amount(int)：消耗金币数
          exchangeNum (int)：兑换礼品数
          exchangeGift（String）:兑换礼品名称

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

返回结果：
{
	{
         "desc": 兑换结果信息,
         "logId": 流水号,
         "status": 0-成功 -1参数错误 1-失败
   }
}

1.8. 取消兑换接口1.0

接口/intf/clubgc/undoExchangeReward.do [post]
请求参数 ：logId(long)：兑换流水账号
           uid (long)：用户id

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

返回结果：
{      
    {
         "desc": "返回跟踪信息",
         "status": 0-成功 -1参数错误 1-失败
    }
}

1.9. 更新用户金币数接口1.0

接口/intf/clubgc/admin/updateAccount.do [post]
请求参数 ：uid(long)：用户id
           amount(int):增加金币数

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

返回结果：
{      
   {
    "desc": 返回信息,
    "status": -1-失败 0-成功
  }
}

2.0. 邀请排行榜接口1.0

接口URL:/intf/club/invitationRankingList.do    [GET]

请求参数：无

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

返回结果：
 code:0成功，-1失败
 message:提示信息

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

  rankingArray: [
             {
          nickname: 用户昵称,
          times: 邀请次数,
          userId: 用户id
           }
    ],
       userInfo: {
         curRanking: 当前排名,
         times: 邀请人数,
         userId: 用户id
      }