兑换商城v2.1.0
<p>[TOC]</p>
<h2>修订记录</h2>
<table>
<thead>
<tr>
<th style="text-align: left;">版本</th>
<th style="text-align: left;">日期</th>
<th style="text-align: left;">操作内容</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">v2.1.0</td>
<td style="text-align: left;">20190228</td>
<td style="text-align: left;">补充</td>
<td style="text-align: left;"></td>
</tr>
</tbody>
</table>
<h2>接口地址</h2>
<p><strong>接口地址</strong>
正式：<a href="http://exchangemall.uc108.com/mobile">http://exchangemall.uc108.com/mobile</a>
内网稳定：<a href="http://exchangemall.uc108.org:1505/mobile">http://exchangemall.uc108.org:1505/mobile</a></p>
<h2>Code码</h2>
<ul>
<li>Code说明字典</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">值</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">0</td>
<td style="text-align: left;">正常</td>
</tr>
<tr>
<td style="text-align: left;">10000</td>
<td style="text-align: left;">服务器处理异常</td>
</tr>
<tr>
<td style="text-align: left;">10001</td>
<td style="text-align: left;">服务暂停</td>
</tr>
<tr>
<td style="text-align: left;">10002</td>
<td style="text-align: left;">IP被限制</td>
</tr>
<tr>
<td style="text-align: left;">10003</td>
<td style="text-align: left;">没有足够的权限</td>
</tr>
<tr>
<td style="text-align: left;">10004</td>
<td style="text-align: left;">请求参数不合法</td>
</tr>
<tr>
<td style="text-align: left;">10005</td>
<td style="text-align: left;">不合法的应用ID</td>
</tr>
<tr>
<td style="text-align: left;">10006</td>
<td style="text-align: left;">不合法的用户ID</td>
</tr>
<tr>
<td style="text-align: left;">10007</td>
<td style="text-align: left;">不合法的授权令牌</td>
</tr>
<tr>
<td style="text-align: left;">10008</td>
<td style="text-align: left;">无效的授权令牌</td>
</tr>
<tr>
<td style="text-align: left;">10009</td>
<td style="text-align: left;">授权令牌已过期</td>
</tr>
<tr>
<td style="text-align: left;">10010</td>
<td style="text-align: left;">未登录</td>
</tr>
<tr>
<td style="text-align: left;">30000</td>
<td style="text-align: left;">活动不存在</td>
</tr>
<tr>
<td style="text-align: left;">30002</td>
<td style="text-align: left;">活动已过期</td>
</tr>
<tr>
<td style="text-align: left;">30003</td>
<td style="text-align: left;">活动奖品不存在</td>
</tr>
<tr>
<td style="text-align: left;">30006</td>
<td style="text-align: left;">奖品发放失败</td>
</tr>
<tr>
<td style="text-align: left;">50001</td>
<td style="text-align: left;">签名验证失败</td>
</tr>
<tr>
<td style="text-align: left;">50002</td>
<td style="text-align: left;">操作标识唯一性验证失败</td>
</tr>
<tr>
<td style="text-align: left;">50003</td>
<td style="text-align: left;">奖励物品单位与数量验证</td>
</tr>
<tr>
<td style="text-align: left;">50004</td>
<td style="text-align: left;">应用验证失败</td>
</tr>
<tr>
<td style="text-align: left;">50005</td>
<td style="text-align: left;">奖励物品合法性验证</td>
</tr>
<tr>
<td style="text-align: left;">50006</td>
<td style="text-align: left;">活动验证失败</td>
</tr>
<tr>
<td style="text-align: left;">50007</td>
<td style="text-align: left;">扩展参数验证不通过</td>
</tr>
<tr>
<td style="text-align: left;">50008</td>
<td style="text-align: left;">兑换券不足</td>
</tr>
<tr>
<td style="text-align: left;">50009</td>
<td style="text-align: left;">凭据不可用</td>
</tr>
<tr>
<td style="text-align: left;">50010</td>
<td style="text-align: left;">兑换失败</td>
</tr>
</tbody>
</table>
<ul>
<li>备注：无</li>
</ul>
<h2>接口</h2>
<h3>1、获取活动最新兑换记录</h3>
<p><strong>简要描述：</strong> </p>
<ul>
<li>获取活动最新兑换记录</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>Activity/GetNewExchangeRecord</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>get </li>
</ul>
<p><strong>参数：</strong> </p>
<pre><code>{ activityGuid:"活动guid "}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"Status": true,
"Code": 0,
"Message": "",
"Data": [
{
"UserName": "ct12313",
"PrizeName": "30元话费"
},
{
"UserName": "ct12313",
"PrizeName": "30元话费"
}
]
}</code></pre>
<h3>2、获取活动奖品列表</h3>
<p><strong>简要描述：</strong> </p>
<ul>
<li>获取活动奖品列表</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>Activity/GetActivityItemList</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>get </li>
</ul>
<p><strong>参数：</strong> </p>
<pre><code>{ activityGuid:"活动guid "}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"Status": true,
"Code": 0,
"Message": "",
"Data": [
{
“PrizeID”:111
"PrizeName": 1,
"ImageUrl": "xxxx",
"Price": 123,
"CurrentTermLeft":123
}
]
}</code></pre>
<h3>3、活动奖品详情【未使用】</h3>
<p><strong>简要描述：</strong> </p>
<ul>
<li>活动奖品详情</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>ActivityItem/GetDetailInfo</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>get </li>
</ul>
<p><strong>参数：</strong> </p>
<pre><code> { activityGuid:"活动guid ",”PrizeID”:111}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"Status": true,
"Code": 0,
"Message": "",
"Data": {
"PrizeName": "美的压力锅",
"Price": 345,
"Descript": "美的压力锅美的压力锅美的压力锅美的压力锅美的压力锅美的压力锅美的压力锅",
"ImageUrl": "xxxxxxxxx",
"ItemPrefixType": "DJ"
}
}</code></pre>
<h3>4、兑换道具/服装等</h3>
<p><strong>简要描述：</strong> </p>
<ul>
<li>兑换道具/服装等</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>Activity/ ExchangeProp</code></li>
</ul>
<p><strong>请求头</strong>
请求头添加 "ClientLinkID":123123
说明：1、kpi接入的传
2、ClientLinkID的值为Client/ReportData接口上报参数ClientLinkID的值</p>
<p><strong>请求方式：</strong></p>
<ul>
<li>post </li>
</ul>
<p><strong>参数：</strong> </p>
<pre><code> { ActivityGuid:"活动guid", PrizeID:2,” Number”:1,” UserID”:1 }</code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"Status": true,
"Code": 0,
"Message": "",
"Data": null
}</code></pre>
<p>备注：Status为true标识兑换成功</p>
<h3>5、兑换实物</h3>
<p><strong>简要描述：</strong> </p>
<ul>
<li>兑换实物</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>Activity/ExchangeRealItem</code></li>
</ul>
<p><strong>请求头</strong>
请求头添加 "ClientLinkID":123123
说明：1、kpi接入的传
2、ClientLinkID的值为Client/ReportData接口上报参数ClientLinkID的值</p>
<p><strong>请求方式：</strong></p>
<ul>
<li>post</li>
</ul>
<p><strong>参数：</strong> </p>
<pre><code> { ActivityGuid:"活动guid", PrizeID:2,” Number”:1,” UserID”:1,” Mobile”:手机号,” Recipients”:”收件人”,” Address”:”收件地址” }</code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"Status": true,
"Code": 0,
"Message": "",
"Data": null
}</code></pre>
<p>备注：Status为true标识兑换成功</p>
<h3>6、兑换话费</h3>
<p><strong>简要描述：</strong> </p>
<ul>
<li>兑换话费</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>Activity/ExchangeMobileBill</code></li>
</ul>
<p><strong>请求头</strong>
请求头添加 "ClientLinkID":123123
说明：1、kpi接入的传
2、ClientLinkID的值为Client/ReportData接口上报参数ClientLinkID的值</p>
<p><strong>请求方式：</strong></p>
<ul>
<li>post</li>
</ul>
<p><strong>参数：</strong> </p>
<pre><code>{ ActivityGuid:"活动guid", PrizeID:2,” Number”:1,” UserID”:1,” Mobile”:手机号” }</code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"Status": true,
"Code": 0,
"Message": "",
"Data": null
}</code></pre>
<p>备注：Status为true标识兑换成功</p>
<h3>7、兑换银子</h3>
<p><strong>简要描述：</strong> </p>
<ul>
<li>兑换银子</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>Activity/ExchangeSilver</code></li>
</ul>
<p><strong>请求头</strong>
请求头添加 "ClientLinkID":123123
说明：1、kpi接入的传
2、ClientLinkID的值为Client/ReportData接口上报参数ClientLinkID的值</p>
<p><strong>请求方式：</strong></p>
<ul>
<li>post</li>
</ul>
<p><strong>参数：</strong> </p>
<pre><code>{ ActivityGuid:"活动guid", PrizeID:2,” Number”:1,” UserID”:1,” Mobile”:手机号” }</code></pre>
<p>备注：SilverTo:1-保险箱、3-IOS后备箱、4-游戏</p>
<p><strong>返回示例</strong></p>
<pre><code> {
"Status": true,
"Code": 0,
"Message": "",
"Data": null
}</code></pre>
<p>备注：Status为true标识兑换成功</p>
<h3>8、我的兑换券记录</h3>
<p><strong>简要描述：</strong> </p>
<ul>
<li>我的兑换券记录</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>UserTickets/GetMyTicketsRecord</code></li>
</ul>
<p><strong>请求头</strong>
请求头添加 "ClientLinkID":123123
说明：1、kpi接入的传
2、ClientLinkID的值为Client/ReportData接口上报参数ClientLinkID的值</p>
<p><strong>请求方式：</strong></p>
<ul>
<li>get</li>
</ul>
<p><strong>参数：</strong> </p>
<pre><code> {
"UserID":1,
"OperateType":1 --操作类型（1，奖励；2，兑换；3，过期）
"PageIndex":1,
"pageSize":20 --可不传，默认为20
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"Status": true,
"Code": 0,
"Message": "",
"Data": [
{
"TicketsChangeNum": 888,
"ChangeRemark": "兑换xxxx物品",
"ChangeTime": "2016/05/30 18:14:00",
"ExpiredTime":20160101
}
]
}</code></pre>
<h3>9、查询指定日期用户会过期兑换券数量</h3>
<p><strong>简要描述：</strong> </p>
<ul>
<li>查询指定日期用户会过期兑换券数量</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>UserTickets/ GetExpireNum</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>get</li>
</ul>
<p><strong>参数：</strong> </p>
<pre><code>{
"UserID":1
"Date":20160707 --可不传，默认获取截止下个月1号过期的
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"Status": true,
"Code": 0,
"Message": "",
"Data": 88888
}</code></pre>
<h3>10、我的兑换券数量</h3>
<p><strong>简要描述：</strong> </p>
<ul>
<li>我的兑换券数量</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>UserTickets/ GetLeftNum</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>get</li>
</ul>
<p><strong>参数：</strong> </p>
<pre><code>{” UserID”:1 }</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"Status": true,
"Code": 0,
"Message": "",
"Data": 88888
}</code></pre>
<h3>11、客户端上报客户端信息接口（KPI项目）【未使用】</h3>
<p><strong>简要描述：</strong> </p>
<ul>
<li>客户端上报客户端信息接口（KPI项目）</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>Client/ReportData</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>post</li>
</ul>
<p><strong>参数：</strong> </p>
<pre><code>{
"ClientLinkID":"",//客户端生成的唯一标识
"GsClientData":"{\"a\":\"a\"}"//客户端信息
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"Code": 0,
"Message": "",
"Data": null
}</code></pre>