接口文档-1.0.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>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">v1.0.0</td>
<td style="text-align: left;">2018.11.26</td>
<td style="text-align: left;">接口完善</td>
<td style="text-align: left;">前端：秦露</td>
<td style="text-align: left;">-</td>
</tr>
</tbody>
</table>
<h2>接口文档维护者（前端 秦露）</h2>
<h2>Code约定</h2>
<h3>通用</h3>
<table>
<thead>
<tr>
<th>code</th>
<th>说明</th>
<th>客户端提示信息</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>成功</td>
<td>-</td>
</tr>
<tr>
<td>10001</td>
<td> 未登录</td>
<td></td>
</tr>
<tr>
<td>101</td>
<td>活动未开始</td>
<td></td>
</tr>
<tr>
<td>102</td>
<td>活动已结束</td>
<td></td>
</tr>
<tr>
<td>103</td>
<td>活动被禁用</td>
<td></td>
</tr>
<tr>
<td>104</td>
<td>活动不存在</td>
<td></td>
</tr>
<tr>
<td>201</td>
<td>未达到可以领奖的状态</td>
<td></td>
</tr>
<tr>
<td>202</td>
<td>已领取奖励</td>
<td></td>
</tr>
<tr>
<td>203</td>
<td>库存不足</td>
<td></td>
</tr>
<tr>
<td>204</td>
<td>待发放</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<h3>通用约定</h3>
<table>
<thead>
<tr>
<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;">协议</td>
<td style="text-align: left;">支持HTTPS/HTTP</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">接口地址</td>
<td style="text-align: left;">开发版：<a href="http://tcyappinvitegift.tcy365.org:1506/">http://tcyappinvitegift.tcy365.org:1506/</a><br>提测版：<a href="http://tcyappinvitegift.tcy365.org:1507/">http://tcyappinvitegift.tcy365.org:1507/</a><br>稳定版：<a href="http://tcyappinvitegift.tcy365.org:1505/">http://tcyappinvitegift.tcy365.org:1505/</a><br> 正式版：<a href="http://tcyappinvitegift.tcy365.com/">http://tcyappinvitegift.tcy365.com/</a> <br>预发版：<a href="http://tcyappinvitegift.tcy365.com:2505/">http://tcyappinvitegift.tcy365.com:2505/</a></td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">Header</td>
<td style="text-align: left;">认证字段：AppKey</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">Content-Type</td>
<td style="text-align: left;">application/json;charset=utf-8</td>
<td style="text-align: left;">-</td>
</tr>
</tbody>
</table>
<h3>后端维护的接口地址</h3>
<p><a href="http://doc.uc108.org:8002/index.php?s=/169&page_id=3309">查看</a></p>
<h2>分享客户端需要的参数（暂时忽略）</h2>
<p><code>分享的连接需要有以下参数</code>：</p>
<table>
<thead>
<tr>
<th style="text-align: left;">字段</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">空</th>
<th>默认</th>
<th>注释</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">abbr</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td></td>
<td>游戏缩写</td>
</tr>
<tr>
<td style="text-align: left;">t</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">否</td>
<td>未使用</td>
<td>链接的类型：平台要传到游戏，用来判断来自什么链接</td>
</tr>
<tr>
<td style="text-align: left;">linktype</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">是</td>
<td>为空处理为0</td>
<td>链接类型：0连接，1海报</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">否</td>
<td></td>
<td>分享类型：0微信，1朋友圈</td>
</tr>
<tr>
<td style="text-align: left;">userid</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td></td>
<td>玩家id</td>
</tr>
<tr>
<td style="text-align: left;">happy</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">否</td>
<td></td>
<td>玩家欢乐币</td>
</tr>
<tr>
<td style="text-align: left;">actid</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">否</td>
<td></td>
<td>活动id</td>
</tr>
<tr>
<td style="text-align: left;">stime</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">否</td>
<td></td>
<td>客户端分享时间</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td></td>
<td>签名</td>
</tr>
<tr>
<td style="text-align: left;">img</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td></td>
<td>头像连接</td>
</tr>
<tr>
<td style="text-align: left;">wxkey</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td></td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td>为空处理为0</td>
<td>头号玩家标记：0非头号赢家，1头号赢家</td>
</tr>
<tr>
<td style="text-align: left;">unionId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td>来自微信</td>
<td>微信unionId</td>
</tr>
<tr>
<td style="text-align: left;">invitewxname</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td></td>
<td>邀请人微信名字，对应游戏方的name</td>
</tr>
<tr>
<td style="text-align: left;">wxname</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td>来自微信</td>
<td>受邀请人微信名字</td>
</tr>
<tr>
<td style="text-align: left;">authorizetime</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">否</td>
<td></td>
<td>授权时间，取本地时间</td>
</tr>
</tbody>
</table>
<h2>与后端对接需要的接口-活动页面</h2>
<h3>奖品类型(Type)的枚举值说明</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">数值</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">1</td>
<td style="text-align: left;">5000两银子</td>
</tr>
<tr>
<td style="text-align: left;">2</td>
<td style="text-align: left;">1元话费</td>
</tr>
<tr>
<td style="text-align: left;">3</td>
<td style="text-align: left;">5元话费</td>
</tr>
<tr>
<td style="text-align: left;">4</td>
<td style="text-align: left;">年卡</td>
</tr>
<tr>
<td style="text-align: left;">5</td>
<td style="text-align: left;">188礼包</td>
</tr>
<tr>
<td style="text-align: left;">6</td>
<td style="text-align: left;">288礼包</td>
</tr>
<tr>
<td style="text-align: left;">7</td>
<td style="text-align: left;">388礼包</td>
</tr>
<tr>
<td style="text-align: left;">8</td>
<td style="text-align: left;">2888礼包</td>
</tr>
</tbody>
</table>
<h3>请求头信息</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">UserId</td>
<td style="text-align: left;">string</td>
<td>用户编号</td>
</tr>
<tr>
<td style="text-align: left;">UserName</td>
<td style="text-align: left;">string</td>
<td>用户名</td>
</tr>
</tbody>
</table>
<h3>接口1:获取活动初始化信息</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong>
<code>get</code></p>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>kssj</td>
<td>number</td>
<td>开始时间,时间戳</td>
<td>-</td>
</tr>
<tr>
<td>jssj</td>
<td>number</td>
<td>时间戳</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code>{
"Code":0, //code值
"Data":{ //数据
"kssj": 0, // 开始时间,时间戳
"jssj": 0 // 结束时间,时间戳
},
"Message":""
}</code></pre>
<p>备注：
101 ：活动未开始
102 ：活动已结束
103 ：活动被禁用
104 ：活动不存在</p>
<h3>接口2:获取邀请有礼的基本信息</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>get</code></p>
<p><strong>请求参数：</strong>
<code>无</code></p>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>yqrs</td>
<td>number</td>
<td>邀请人数</td>
<td>-</td>
</tr>
<tr>
<td>hdyz</td>
<td>number</td>
<td>获得银子</td>
<td>-</td>
</tr>
<tr>
<td>- jp</td>
<td>array</td>
<td>奖品:的排序按照原型图的顺序依次返回(从左到右、从上到下)</td>
<td>-</td>
</tr>
<tr>
<td>id</td>
<td>number</td>
<td>奖品id</td>
<td>-</td>
</tr>
<tr>
<td>jpm</td>
<td>string</td>
<td>奖品名</td>
<td>-</td>
</tr>
<tr>
<td>jpsl</td>
<td>number</td>
<td>奖品剩余数量</td>
<td>-</td>
</tr>
<tr>
<td>jplx</td>
<td>number</td>
<td>奖品类型:根据约定的枚举值来</td>
<td>-</td>
</tr>
<tr>
<td>jplqzt</td>
<td>number</td>
<td>201不可领取,202已领取,203已领完(库存不足)</td>
<td>-</td>
</tr>
<tr>
<td>- xygklqdtdjl</td>
<td>object</td>
<td>下一个可领取的梯度奖励</td>
<td>特别说明，如果没有下一个可领取的梯度奖励，该字段为<code>null</code></td>
</tr>
<tr>
<td>yqrs</td>
<td>number</td>
<td>邀请人数</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code>{
"Code":0, //code值
"Data":{ //数据
"yqrs":12, // 邀请人数
"hdyz":5000, // 获得银子
"jp":[{ // 奖品:的排序按照原型图的顺序依次返回
"id": 1, // 奖品id
"jpm": "5000两银子", // 奖品名
"jpsl": 0, // 奖品剩余数量
"jplx": 1, // 奖品类型:根据约定的枚举值来
"jplqzt": 0 // 奖品领取状态:0待领取,201不可领取,202已领取,203已领完(库存不足)
}],
"xygklqdtdjl":{ // 下一个可领取的梯度奖励，如果不存在，则为null
"yqrs": 0, // 邀请人数
"yqrs": 1 // 奖品类型:根据约定的枚举值来
}
},
"Message":""
}</code></pre>
<h3>接口3:领取奖励</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>get</code></p>
<p><strong>请求参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必选</th>
<th>默认值</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>奖品id</td>
<td>-</td>
</tr>
<tr>
<td>jpdqzt</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>奖品当前状态:0待领取,201不可领取,202已领取,203已领完(库存不足)</td>
<td>-</td>
</tr>
<tr>
<td>jplx</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>奖品类型:根据约定的枚举值来</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<pre><code>{
"id": 1, // 奖品id
"jpdqzt": 1, // 奖品当前状态:0待领取,201不可领取,202已领取,203已领完(库存不足)
"jplx": 1 // 奖品类型:根据约定的枚举值来
}</code></pre>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>dhm</td>
<td>string</td>
<td>兑换码</td>
<td>特别说明：只有当领取的是旅游年卡的时候，该字段有数据，其余情况该字段为空字符串</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code>{
"Code":0, //code值
"Data":{ //数据
"dhm":"SSDDSD" // 兑换码
},
"Message":""
} </code></pre>
<h3>接口4:话费领取（填写信息）</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>get</code></p>
<p><strong>请求参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必选</th>
<th>默认值</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>奖品id</td>
<td>-</td>
</tr>
<tr>
<td>jpdqzt</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>奖品当前状态:0待领取,201不可领取,202已领取,203已领完(库存不足)</td>
<td>-</td>
</tr>
<tr>
<td>jplx</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>奖品类型:根据约定的枚举值来</td>
<td>-</td>
</tr>
<tr>
<td>dhhm</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>电话号码</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<pre><code>{
"id": 1, // 奖品id
"jpdqzt": 1, // 奖品当前状态:0待领取,201不可领取,202已领取,203已领完(库存不足)
"jplx": 1, // 奖品类型:根据约定的枚举值来
"dhhm":18723860669 // 电话号码
}</code></pre>
<p><strong>返回示例：</strong></p>
<pre><code>{
"Code":0, //code值
"Data":{ //数据
},
"Message":""
}</code></pre>
<h3>接口5:礼包领取（填写信息）</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>get</code></p>
<p><strong>请求参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必选</th>
<th>默认值</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>奖品id</td>
<td>-</td>
</tr>
<tr>
<td>jpdqzt</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>奖品当前状态:0待领取,201不可领取,202已领取,203已领完(库存不足)</td>
<td>-</td>
</tr>
<tr>
<td>jplx</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>奖品类型:根据约定的枚举值来</td>
<td>-</td>
</tr>
<tr>
<td>sjr</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>收件人</td>
<td>-</td>
</tr>
<tr>
<td>dhhm</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>电话号码</td>
<td>-</td>
</tr>
<tr>
<td>dz</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>地址</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<pre><code>{
"id": 1, // 奖品id
"jpdqzt": 1, // 奖品当前状态:0待领取,201不可领取,202已领取,203已领完(库存不足)
"jplx": 1, // 奖品类型:根据约定的枚举值来
"sjr":"阿西吧", // 收件人
"dhhm":18723860669, // 电话号码
"dz":"畅唐网络" // 地址
}</code></pre>
<p><strong>返回示例：</strong></p>
<pre><code>{
"Code":0, //code值
"Data":{ //数据
},
"Message":""
}</code></pre>
<h2>与后端对接需要的接口-微信邀请有礼页面</h2>
<h3>接口1:获取活动基本信息</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>get</code></p>
<p><strong>请求参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必选</th>
<th>默认值</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>abbr</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>游戏缩写</td>
<td>-</td>
</tr>
<tr>
<td>activityId</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>活动id</td>
<td>-</td>
</tr>
<tr>
<td>unionId</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>微信unionId</td>
<td>-</td>
</tr>
<tr>
<td>type</td>
<td>number</td>
<td>是</td>
<td>""</td>
<td>0非头号赢家，1头号赢家</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<pre><code>{
"abbr":"", //游戏缩写
"activityId":0 , //活动id
"unionId":2324,
"type":0
}
</code></pre>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>AvatarPicture</td>
<td>string</td>
<td>微信头像</td>
<td>-</td>
</tr>
<tr>
<td>Title</td>
<td>string</td>
<td>文案:头像旁的文案</td>
<td>-</td>
</tr>
<tr>
<td>GameLogo</td>
<td>string</td>
<td>游戏logo</td>
<td>-</td>
</tr>
<tr>
<td>GameName</td>
<td>string</td>
<td>游戏名</td>
<td>-</td>
</tr>
<tr>
<td>Abbr</td>
<td>string</td>
<td>游戏名缩写</td>
<td>-</td>
</tr>
<tr>
<td>InviteBgPicUrl</td>
<td>string</td>
<td>邀请的宣传图</td>
<td>-</td>
</tr>
<tr>
<td>DownLoadType</td>
<td>number</td>
<td>下载类型:区分下载包1和下载页面地址0</td>
<td>-</td>
</tr>
<tr>
<td>IosDownLoadUrl</td>
<td>string</td>
<td>ios下载地址或者下载页面地址</td>
<td>-</td>
</tr>
<tr>
<td>AndroidDownLoadUrl</td>
<td>string</td>
<td>Android下载地址或者下载页面地址</td>
<td>-</td>
</tr>
<tr>
<td>RuleContent</td>
<td>string</td>
<td>规则描述</td>
<td>-</td>
</tr>
<tr>
<td>PosterPicUrl</td>
<td>string</td>
<td>海报背景宣传图</td>
<td>-</td>
</tr>
<tr>
<td>InvitePicUrl</td>
<td>string</td>
<td>邀请有礼图片链接</td>
<td>-</td>
</tr>
<tr>
<td>LimitNum</td>
<td>nuber</td>
<td>限制次数</td>
<td>-</td>
</tr>
<tr>
<td>AcceptStatus</td>
<td>nuber</td>
<td>（new）领奖状态：0可以领奖，101已经领奖，102领奖失败<br/>（old废弃）领奖状态：0可以领奖，1已经领奖，2领奖失败</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code>{
"StatusCode": 0, //code值
"Data": { //数据
"AvatarPicture": "", // 微信头像
"Title": "", // 文案:头像旁的文案
"GameLogo": "", // 游戏logo
"GameName": "", // 游戏名
"Abbr": "", // 游戏名缩写
"InviteBgPicUrl": "", // 邀请的宣传图
"DownLoadType": 0, // 下载类型:区分下载包1和下载页面地址0
"IosDownLoadUrl": "", //ios下载地址或者下载页面地址
"AndroidDownLoadUrl": "", //Android下载地址或者下载页面地址
"RuleContent": "" ,//规则描述
"PosterPicUrl":"海报背景宣传图",
"InvitePicUrl": "邀请有礼图片链接",
"LimitNum":3,
"AcceptStatus":0
},
"Message": ""
}</code></pre>
<h3>接口2:邀请人和受邀人关系绑定接口</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>进入页面，非头号赢家领取奖励触发</li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>post</code></p>
<p><strong>请求参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必选</th>
<th>默认值</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>abbr</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>游戏缩写</td>
<td>-</td>
</tr>
<tr>
<td>sourcetype</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>分享来源</td>
<td>-</td>
</tr>
<tr>
<td>inviteuid</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>邀请人用户Id</td>
<td>-</td>
</tr>
<tr>
<td>invitewxname</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>邀请人微信昵称</td>
<td>-</td>
</tr>
<tr>
<td>invitedunionid</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>受邀请人unionId</td>
<td>-</td>
</tr>
<tr>
<td>wxname</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>受邀请人昵称</td>
<td>-</td>
</tr>
<tr>
<td>gametotaltime</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>游戏时长值</td>
<td>-</td>
</tr>
<tr>
<td>happyvalue</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>欢乐点</td>
<td>-</td>
</tr>
<tr>
<td>Sign</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>签名</td>
<td>-</td>
</tr>
<tr>
<td>authorizetime</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>授权时间</td>
<td>-</td>
</tr>
<tr>
<td>sharetime</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>分享时间</td>
<td>-</td>
</tr>
<tr>
<td>activityid</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>活动id</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<pre><code>{
"abbr":"", //游戏缩写
"sourcetype": "", //分享来源
"inviteuid":0, //邀请人用户Id
"invitewxname": "", //邀请人微信昵称
"invitedunionid": 0, // 受邀请人unionId
"wxname": "", //受邀请人昵称
"gametotaltime": 0, //游戏时长值
"happyvalue":0, //欢乐点
"Sign": "", //签名
"authorizetime": 0, //授权时间
"sharetime": 0, // 分享时间
"activityid": 0 // 活动id
}</code></pre>
<p>备注：签名规则按照下边的这种格式：
（“abbr&sourcetype&inviteuid&invitedunionid”,”D92B4F5BA37631F5”）.ToMD5()，游戏方直接提供</p>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>Data</td>
<td>number</td>
<td>0</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code>{
"StatusCode":0, //code值
"Data":0,
"Message":""
}
</code></pre>
<h3>接口3:获取APP下载地址</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>get</code></p>
<p><strong>请求参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必选</th>
<th>默认值</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>abbr</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>游戏缩写</td>
<td>-</td>
</tr>
<tr>
<td>activityid</td>
<td>number</td>
<td>是</td>
<td>""</td>
<td>活动id</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<pre><code>{
"abbr":"", //游戏缩写
"activityid": "" //游戏id
}</code></pre>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>DownLoadType</td>
<td>number</td>
<td>下载类型:1下载包地址,0下载页面地址</td>
<td>-</td>
</tr>
<tr>
<td>IosDownLoadUrl</td>
<td>string</td>
<td>ios下载包或者下载页面地址</td>
<td>-</td>
</tr>
<tr>
<td>AndroidDownLoadUrl</td>
<td>string</td>
<td>安装下载包或者下载页面地址</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code>{
"StatusCode":0, //code值
"Data":{ //数据
"DownLoadType": 0, // 下载类型:1下载包地址,0下载页面地址
"IosDownLoadUrl": "", // ios下载包 或者 下载页面地址
"AndroidDownLoadUrl": "" // 安装下载包 或者 下载页面地址
},
"Message":""
}
</code></pre>
<p>备注：这个接口不区分活动的状态，如是否在活动期间！</p>
<h3>接口4:领奖接口</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>get</code></p>
<p><strong>请求参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必选</th>
<th>默认值</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>Abbr</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>游戏缩写</td>
<td>-</td>
</tr>
<tr>
<td>unionId</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>微信unionId</td>
<td>-</td>
</tr>
<tr>
<td>ActivityId</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>活动id</td>
<td>-</td>
</tr>
<tr>
<td>Type</td>
<td>number</td>
<td>是</td>
<td>""</td>
<td>0非头号赢家，1头号赢家</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<pre><code>{
"Abbr":0, //游戏缩写
"unionId":"", //微信unionId
"type":0 ,// 0非头号赢家，1头号赢
"activityId":0 // 活动id
}
</code></pre>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>AwardTip</td>
<td>string</td>
<td>奖励</td>
<td>-</td>
</tr>
<tr>
<td>- Gifts</td>
<td>array</td>
<td>-</td>
</tr>
<tr>
<td>ItemID</td>
<td>number</td>
<td>-</td>
</tr>
<tr>
<td>Number</td>
<td>number</td>
<td>-</td>
</tr>
<tr>
<td>Name</td>
<td>string</td>
<td>-</td>
</tr>
<tr>
<td>UnitName</td>
<td>string</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code>{
"StatusCode":0, //code值
"Data":{ //数据
"AwardTip":"dsa",
"Gifts": [{
"ItemID": 21617,
"Number": 10,
"Name": "欢乐币",
"UnitName": "张"
}]
},
"Message":""
}
</code></pre>
<p>备注：
已领过奖：StatusCode的值101
领奖失败：StatusCode的值102</p>