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

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


提交成长任务(会员成长值)或积分任务

<h5>简要描述:</h5> <ul> <li>获取任务接口</li> <li>接口统一使用的编码为:UTF-8</li> <li><strong>提交任务涉及接入方服务接口</strong>:自有积分体系提供 <a href="https://www.showdoc.com.cn/1procedure2develop?page_id=3125134758885194" title="任务回调接口+salt">任务回调接口+salt</a> ;积分托管珊瑚提供 <a href="https://www.showdoc.com.cn/1procedure2develop?page_id=3125133239575152" title="登录校验接口">登录校验接口</a></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>任务体系类型,值Coin(积分奖励)或Grow(会员成长)</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>

页面列表

ITEM_HTML