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

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


返还积分回调

<h4>返还积分回调(要求必须是https)</h4> <ul> <li>接入方提供,在珊瑚后台配置。自有积分体系的,接入商城h5才需要。</li> <li>accountID、payno、orderid、appsign要校验。不要固定返回成功。</li> <li>payno不是必须的。如果珊瑚服务和接入方服务积分扣除接口超时,则会调用返还积分对这个订单进行回滚,因此接入方开发返还积分接口时,应该设计为空回滚,即无论这个订单号是否真实存在,或者已经返还过,都应该返回给珊瑚服务器成功的标示(ret为0)</li> <li><strong>重要:</strong>必须要做好参数防sql注入!!!</li> </ul> <p><strong>简要描述:</strong></p> <ul> <li>接口统一使用的编码为:UTF-8</li> <li>当我们收到端侧请求过来的返还积分请求时,我们会实时请求你们的服务器。</li> <li>需要开发者提供一个自己服务器返还积分的地址,接口接收数据的方式:POST</li> <li>积分返还接口测试方法:在兑换记录中,对兑换成功且未发奖的订单,手动返还积分。(路径:商城运营---积分商城---兑换记录明细---开启编辑模式---返还积分)</li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <p><strong> 请求参数:</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;">accountid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>用户id</td> </tr> <tr> <td style="text-align: left;">coinnum</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>扣除积分数</td> </tr> <tr> <td style="text-align: left;">loginkey</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>校验身份串</td> </tr> <tr> <td style="text-align: left;">appid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>分配的appid</td> </tr> <tr> <td style="text-align: left;">appsign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>加密签名</td> </tr> <tr> <td style="text-align: left;">timestamp</td> <td style="text-align: left;">是</td> <td style="text-align: left;">long</td> <td>时间戳</td> </tr> <tr> <td style="text-align: left;">payno</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>订单回执(不重复)</td> </tr> <tr> <td style="text-align: left;">orderid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>订单号(不重复),即当初扣积分时的orderID</td> </tr> </tbody> </table> <p><strong>返回示例</strong></p> <pre><code> { "ret": 0, "data": { "left_coin":0 }, "msg": "" }</code></pre> <p><strong>返回参数说明</strong> </p> <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;">ret</td> <td style="text-align: left;">int</td> <td>0成功,1失败,如果该回执已返还过积分,也返回0</td> </tr> <tr> <td style="text-align: left;">left_coin</td> <td style="text-align: left;">int</td> <td>剩余积分值</td> </tr> </tbody> </table> <p><strong>备注</strong> </p> <ul> <li>appsign的加密方式可以参考首页菜单的签名方式</li> </ul>

页面列表

ITEM_HTML