[[TOC]]

= 试用体验 =

== 获取新通过和未通过的试用数 ==

> /app/my/trial/getNewCountForApp.jsp

**说明**

> 获取某一个时间点后用户被审核通过和未被通过的试用数量

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||lastAccessTime||最近一次访问该接口的时间||时间戳 毫秒||当前时间||是||
||common_session_id||-||String||""||是||

**返回**
{{{#!java
result:{
    status:1,
    msg:"请求成功",
    data:{
        passCount: 2    // 新审核通过的试用数量
        noPassCount: 2  // 新审核未通过的试用数量
    }
}
        
}}}

== 判断用户是否已申请 ==

> /app/my/trial/hasApplyForActivity.jsp

**说明**

> 判断用户是否已经申请

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||activityId||试用id||int||0||是||
||common_session_id||-||String||""||是||

**返回**
{{{#!java
result:{
    status:1,
    msg:"请求成功",
    data:{
        hasApply: 1  // 1 表示已申请  0 表示未申请
    }
}
        
}}}

== 获取试用总数 ==

> /app/my/trial/getTotalCountForApp.jsp

**说明**

> 获取某一个用户的试用总数

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||common_session_id||-||String||""||是||

**返回**
{{{#!java
result:{
    status:1,
    msg:"请求成功",
    data:{
        trialCount: 2  
    }
}
        
}}}

== 自设定试用 ==

> /app/service/setupActivity.jsp

**说明**

> 推荐试用，由编辑在后台设定并设置好展示位置。

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||limit||限制条数||int||1||是||
||common_session_id||-||String||""||否||

**返回**

{{{#!java
result: {
	status: 1
	limit： 1,
	msg: '请求成功',
        data: [
                {
                  "activityId" 试用活动id
                  "title"      试用活动标题
                  "applyEndAt" 申请结束时间
                  "type"       活动类型 0海测 1精测
                  "quantity"   产品数量
                  "applyCount" 提交申请的人数
                  "face_1"     390x195封面
                  "face_2"     540x270封面
                  "face_3"     130x130封面
                  "face_4"     140x170封面
               }
          ]
}
}}}

----------
== 某个时间后的有效试用条数 ==

> /app/service/countActivity.jsp

**说明**

> 某个时间后的有效试用条数。

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||limit||限制条数||int||1||否||
||date||时间毫秒数||long||当前时间||是||

**返回**

{{{#!java
result: {
	status: 1
	limit： 1,
	msg: '请求成功',
        data: 有效试用个数
}
}}}
== 我的试用 ==

> /app/my/trial/listMyApply.jsp

**说明**

> 获取到已通过，申请中，未通过3中类型的使用申请

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||pageNo||页数||int||1||是||
||pageSize||页面大小||int||10||是||
||status||0 申请中  -1未通过  1通过||int||2||是||
||common_session_id||-||String||""||是||

**返回**

{{{#!java
result {
    status: 1, 
    pageNo： 1
    pageSize： 1,
    total: 1,
    pageTotal: 1,
    msg: '请求成功',
    data: [
            {
                "applyId"    试用申请id
                "activityId" 试用活动id
                "title"      试用活动标题
                "status"     试用申请状态
                "createAt"   试用申请时间
                "face_1"     390x195封面
                "face_2"     540x270封面
                "face_3"     130x130封面
                "face_4"     140x170封面
            }
    ]
}
}}}

----------

== 最新试用 ==

> /app/trial/cache/getNewActivity.jsp

**说明**

> 获取最新的一个有效的试用

**提交方式**

> GET

**请求参数**

**返回**

{{{#!java
result {
	status: 1
	msg: '请求成功',
        data: {   //无试用时data为null
                  "activityId" 试用活动id
                  "title"      试用活动标题
                  "applyEndAt" 申请结束时间
                  "type"       活动类型 0海测 1精测
                  "quantity"   产品数量
                  "applyCount" 提交申请的人数
                  "face_1"     390x195封面
                  "face_2"     540x270封面
                  "face_3"     130x130封面
                  "face_4"     140x170封面
                }
}
}}}

----------

== 获取试用类型列表 ==

> /app/trial/cache/listActivityTypeList.jsp

**说明**

> 获取试用类型列表

**提交方式**

> GET

**返回**

{{{#!java
result {
	status: 1
	msg: '请求成功',
	data :{
		[
                   "activityTypeId"  类别ID
                   "parentId"        父类别ID
                   "name"            类别名称
                ]
	}
}
}}}

----------

== 获取试用列表 ==

> /app/trial/listActivityList.jsp

**说明**

> 根据分类获取试用列表

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||pageNo||页数||int||1||是||
||pageSize||页面大小||int||10||是||
||activityTypeId||试用类型id，0表示全部||int||0||是||

**返回**

{{{#!java
result {
	status: 1
	pageNo： 1
	pageSize： 20,
	total: 100,
	pageTotal: 5,
	msg: '请求成功',
	trialType： 2
	data: [
                 {
                  "activityId" 试用活动id
                  "title"      试用活动标题
                  "applyEndAt" 申请结束时间
                  "type"       活动类型 0海测 1精测
                  "quantity"   产品数量
                  "applyCount" 提交申请的人数
                  "face_1"     390x195封面
                  "face_2"     540x270封面
                  "face_3"     130x130封面
                  "face_4"     140x170封面
                 }
              ]
}
}}}

----------


== 试用详情 ==

> /app/trial/getActivityInfo.jsp

**说明**

> 用于渲染wap页面

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||activityId||试用id||int||0||是||
||fontSize||wap页面字号||int||14||是||

**返回**

{{{#!java
result {
	status: 1
	msg: '请求成功',
	data: {
                  "activityId" 试用活动id
                  "title"      试用活动标题
                  "applyEndAt" 申请结束时间
                  "type"       活动类型 0海测 1精测
                  "quantity"   产品数量
                  "applyCount" 提交申请的人数
                  "gold"       试用所需金币
                  "cost"       试用所需积分
                  "worth"      试用品价格
                  "provider"   试用品提供商
                  "text"       试用品介绍
                  "face_1"     390x195封面
                  "face_2"     540x270封面
                  "face_3"     130x130封面
                  "face_4"     140x170封面
              }
}
}}}

----------

== 申请试用 ==

> /app/my/trial/createApply.jsp

**说明**

> 申请试用，需填写姓名（最多输入待定个字符）、手机号码（需为1开头的11位数字）、寄送地址（最多输入待定个字符）、QQ号码（需为5~11位数字）、申请理由（至少输入20个汉字）。申请按钮固定在屏幕底部，不随页面滚动。点击”提交申请“，若各输入项均符合规则，则提示申请已受理并返回试用详情页。点击”提交申请“，若某个输入项不符合规则，则页面显示相应提示。

**提交方式**

> POST

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||activityId||试用id||long||0||是||
||name||姓名||String||""||是||
||telNum||手机号码||int||0||是||
||address||寄送地址||String||""||是||
||qq||qq号码||int||0||是||
||reason||申请理由||String||""||是||
||common_session_id||-||String||""||是||

**返回**

{{{#!java
result {
	status: 1,
	msg: '申请成功'
}
}}}