获取会员成长任务或积分任务
<h5>简要描述:</h5>
<ul>
<li>获取任务接口</li>
<li>接口统一使用的编码为:UTF-8</li>
</ul>
<h5>请求URL:</h5>
<ul>
<li>/ext/getTask2
测试环境域名是https://testgmall.m.qq.com 正式环境域名是https://gmall.m.qq.com</li>
</ul>
<p>签名规则:<a href='https://www.showdoc.cc/1procedure2develop?page_id=3125189450329585'>签名<a/>
注意本接口签名requestBody参数要进行<strong>字典排序</strong>之后参与签名。</p>
<p><strong> querystring参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">appid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>产品id</td>
</tr>
<tr>
<td style="text-align: left;">_timestamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>时间戳</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>参考签名规则,32位小写</td>
</tr>
</tbody>
</table>
<h5>请求方式:</h5>
<ul>
<li>get
<strong>参数:</strong></li>
</ul>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>account_id</td>
<td>是</td>
<td>string</td>
<td>用户账号id</td>
</tr>
<tr>
<td>device_id</td>
<td>否</td>
<td>string</td>
<td>设备id任务类型列表</td>
</tr>
<tr>
<td>login_key</td>
<td>是</td>
<td>string</td>
<td>登陆校验串</td>
</tr>
<tr>
<td>task_type_list</td>
<td>否</td>
<td>string</td>
<td>1、所有任务: "" 2、多任务类型传参: 102-103-104,用-分隔任务类型</td>
</tr>
<tr>
<td>activity_type</td>
<td>是</td>
<td>string</td>
<td>任务体系类型,值Coin(积分奖励)或Grow(会员成长)</td>
</tr>
</tbody>
</table>
<p><strong>activity_type说明:</strong>
Coin类型,是积分任务,给用户的是积分值奖励,可用于积分兑换交易;
Grow是会员任务,给用户的是成长值,用于会员等级升级。</p>
<p><strong>返回示例 </strong> </p>
<pre><code class="language-json">type = 1
{
ret: 0,
data: {
"task_list": [
{
"task_type": 102,
"task_id": 947,
"total_count": 1,
"remain_count": 1,
"show_ui": {},
"order_list": [
{
"order_id": "442211087731924000",
"order_status": 5,
"coin_num": 1,
"assign_timestamp": 1589126400,
"submit_timestamp": 0,
"expire_timestamp": 1589299200,
"order_data": [12,2,2,-1]
}],
"coin_type": "",
"current_task_order_id": "3651131386356571171",
"done_times": 2,
"total_times": 3,
"task_event_code": "",
}
],
"total_coin": 0,
},
msg: "suc"
}
</code></pre>
<p><strong>返回参数说明</strong></p>
<p><strong>task_list</strong></p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>task_type</td>
<td>int</td>
<td>任务类型</td>
</tr>
<tr>
<td>task_id</td>
<td>int</td>
<td>任务ID</td>
</tr>
<tr>
<td>total_count</td>
<td>int</td>
<td>任务总数</td>
</tr>
<tr>
<td>remain_count</td>
<td>int</td>
<td>剩余次数</td>
</tr>
<tr>
<td>show_ui</td>
<td>int</td>
<td>任务展示素材</td>
</tr>
<tr>
<td>order_list</td>
<td>int</td>
<td>每个任务类型的订单按创建时间排序</td>
</tr>
<tr>
<td>current_task_order_id</td>
<td>string</td>
<td>计次任务:当前任务订单号(未发布)</td>
</tr>
<tr>
<td>done_times</td>
<td>int</td>
<td>计次任务:当前任务已提交数(未发布)</td>
</tr>
<tr>
<td>total_times</td>
<td>int</td>
<td>计次任务:完成单个计次任务所需要的提交数(未发布)</td>
</tr>
<tr>
<td>task_event_code</td>
<td>string</td>
<td>任务事件Code,未绑定则返回空字符串''(未发布)</td>
</tr>
</tbody>
</table>
<p><strong>order_list</strong></p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>order_id</td>
<td>string</td>
<td>订单号</td>
</tr>
<tr>
<td>order_status</td>
<td>short</td>
<td>1 :、初始状态,2、完成状态,不获得积分 3、提交状态,获得积分 4、过期状态 5、分配的补做任务-初始状态 6 、分配的补做任务-完成状态 7 、分配的补做任务-提交状态 8、 初始在GUID,合并到ACCOUNT的任务 - 已合并 9、初始在GUID,合并到ACCOUNT的任务 - 合并的完成任务 10、初始在GUID,合并到ACCOUNT的任务 - 合并的补做任务</td>
</tr>
<tr>
<td>coin_num</td>
<td>int</td>
<td>完成任务获得成长值</td>
</tr>
<tr>
<td>assign_timestamp</td>
<td>long</td>
<td>订单创建时间</td>
</tr>
<tr>
<td>submit_timestamp</td>
<td>long</td>
<td>订单完成时间</td>
</tr>
<tr>
<td>expire_timestamp</td>
<td>long</td>
<td>订单过期时间</td>
</tr>
<tr>
<td>order_data</td>
<td>array</td>
<td>check任务或者submit任务时,客户端回传</td>
</tr>
</tbody>
</table>
<p><strong>order_status含义解释</strong></p>
<table>
<thead>
<tr>
<th>order_status</th>
<th>状态含义</th>
<th>接入方处理</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>初始任务,未完成</td>
<td>接入方判断任务完成了可提交以获得积分</td>
</tr>
<tr>
<td>2</td>
<td>已完成,未提交任务</td>
<td>可直接提交,获得积分</td>
</tr>
<tr>
<td>3</td>
<td>已完成,且已提交获得积分任务</td>
<td>已完成订单,无需再处理,不能提交</td>
</tr>
<tr>
<td>4</td>
<td>过期任务,提交后不获得积分</td>
<td>过期的任务,无需完成,无需提交。可过滤掉</td>
</tr>
<tr>
<td>5</td>
<td>补做-初始任务,未完成</td>
<td>接入方判断任务完成了,可提交以获得积分</td>
</tr>
<tr>
<td>6</td>
<td>补做-完成任务,未提交</td>
<td>可直接提交,获得积分</td>
</tr>
<tr>
<td>7</td>
<td>补做-完成任务,且已提交获得积分</td>
<td>已完成订单,无需再处理,不能提交</td>
</tr>
<tr>
<td>8</td>
<td>常规用户体系不会遇到</td>
<td></td>
</tr>
<tr>
<td>9</td>
<td>常规用户体系不会遇到</td>
<td></td>
</tr>
<tr>
<td>10</td>
<td>常规用户体系不会遇到</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/3a34ed932558786bd90f88148053ffd6?showdoc=.jpg" alt="" />
<strong>注意</strong>:api对接任务,没有check接口,直接使用submit
<strong>相关链接</strong></p>
<p>1、<a href='https://www.showdoc.cc/1procedure2develop?page_id=4446092733946483'>提交任务接口<a/></p>
<p>2、<a href="https://www.showdoc.cc/1procedure2develop?page_id=4130679322913523" title="任务相关错误码自查">任务相关错误码自查</a></p>