腾讯珊瑚接入流程和开发指引

接入流程+开发工作量+开发接口


获取会员成长任务或积分任务

<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、所有任务: &quot;&quot; 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>

页面列表

ITEM_HTML