提交成长任务(会员成长值)或积分任务
<h5>简要描述:</h5>
<ul>
<li>获取任务接口</li>
<li>接口统一使用的编码为:UTF-8</li>
</ul>
<h5>请求URL:</h5>
<ul>
<li>/ext/submitTask2
测试环境域名是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>POST
<strong>参数:</strong></li>
</ul>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>order_data</td>
<td>是</td>
<td>array</td>
<td>任务订单,客户端回传字段(此参数不参与签名)</td>
</tr>
<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>activity_type</td>
<td>是</td>
<td>string</td>
<td>任务体系类型,值 Grow(会员成长积分) 或 Coin</td>
</tr>
<tr>
<td>login_key</td>
<td>是</td>
<td>string</td>
<td>登录态(传空会透传给,客户校验接口)</td>
</tr>
<tr>
<td>task</td>
<td>否</td>
<td>array</td>
<td>用户在客户业务侧完成的任务(自行上报成长值的接口可以不传)</td>
</tr>
</tbody>
</table>
<p>task参数定义
(1)若任务是在珊瑚后台编辑且配置好对应的积分值(后台配置固定值),可不传
【例子】若已在珊瑚后台配置一条积分任务(任务id为“a”,任务名为“登录小程序”,对应积分值“10积分”),则客户每次判断用户完成小程序登录动作后,调一次任务a,则可对该用户增加10积分。此情况不必传task参数</p>
<p>(2)若任务在客户业务侧生成,依赖客户信息同步才可获得对应积分值(后台配置客户上传),则需传输
【例子】若客户在业务侧制定了较复杂的任务序列与对应的积分值,如:
一年内旅客乘坐飞机5次(含)以下,每次+10积分;
一年内旅客乘坐飞机6次以上,10次(含)以下,每次+15积分;
一年内旅客乘坐飞机10次以上,每次+30积分
那么,某个用户在具体某次乘机获得的积分数,需要业务侧判断好,同步给珊瑚才能对该用户增加对应的积分值。这种情况,则需要传task参数</p>
<p><strong>task</strong></p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>order_id</td>
<td>是</td>
<td>array</td>
<td>订单id</td>
</tr>
<tr>
<td>task_id</td>
<td>是</td>
<td>array</td>
<td>任务id</td>
</tr>
<tr>
<td>coin_base</td>
<td>是</td>
<td>string</td>
<td>用户在客户侧的任务基数</td>
</tr>
<tr>
<td>coin_num</td>
<td>是</td>
<td>string</td>
<td>用户在客户侧完成任务后拿到的奖励</td>
</tr>
<tr>
<td>finish_timestamp</td>
<td>是</td>
<td>int</td>
<td>完成时间</td>
</tr>
<tr>
<td>verify_data</td>
<td>否</td>
<td>string</td>
<td>透传给客户的校验串</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code class="language-json"> {
"ret": 0,
"data": {
"ret": 0,
"task_coin": [
{
"order_id": "",
"ret": 0,
"coin_num": 0,
"task_id": 0,
"task_type": 0
}
],
"total_coin": 0,
"bonus": [
{
"order_id": "",
"ret": 0,
"coin_num": 0,
"task_id": 0,
"task_type": 0
}
]
}
}
</code></pre>
<p><strong>返回参数说明</strong></p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>task_coin</td>
<td>array</td>
<td>订单任务结果列表</td>
</tr>
<tr>
<td>total_coin</td>
<td>int</td>
<td>积分总数</td>
</tr>
<tr>
<td>bonus</td>
<td>array</td>
<td>奖励任务</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>order_id</td>
<td>array</td>
<td>订单任务结果列表</td>
</tr>
<tr>
<td>ret</td>
<td>int</td>
<td>任务订单提交的状态码(此值等于0,任务完成,否则未完成)</td>
</tr>
<tr>
<td>coin_num</td>
<td>int</td>
<td>完成任务获得成长值</td>
</tr>
<tr>
<td>task_id</td>
<td>int</td>
<td>任务ID</td>
</tr>
<tr>
<td>task_type</td>
<td>int</td>
<td>任务类型</td>
</tr>
</tbody>
</table>
<p>相关链接</p>
<p>1、<a href="https://www.showdoc.cc/1procedure2develop?page_id=4130679322913523" title="任务相关错误码自查">任务相关错误码自查</a></p>