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

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


兑换接口

<p><strong>简要描述:</strong> </p> <ul> <li>积分商品兑换(该接口需要签名)</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>/ext/mall/exchange</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <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;">long</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>MD5签名32位小写</td> </tr> </tbody> </table> <p><strong>requestBody 参数:</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;">account_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>账号</td> </tr> <tr> <td style="text-align: left;">cost</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>消费的数量 ,暂时只支持1个</td> </tr> <tr> <td style="text-align: left;">device_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>设备</td> </tr> <tr> <td style="text-align: left;">exc_detail</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>兑换信息(q号/手机号/收货地址) ;无兑换信息时,传accountid</td> </tr> <tr> <td style="text-align: left;">mid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>商品的id</td> </tr> <tr> <td style="text-align: left;">order_id</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>自定义定义订单id</td> </tr> <tr> <td style="text-align: left;">login_key</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>登陆校验Key</td> </tr> <tr> <td style="text-align: left;">ext</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>扩展参数,自定义商品兑换才有,这参数会透传给自定义商品发奖接口的ext参数</td> </tr> </tbody> </table> <p><strong>返回示例</strong></p> <pre><code> { &amp;quot;ret&amp;quot;: 0, &amp;quot;data&amp;quot;: { &amp;quot;last_cnt&amp;quot;: 19, &amp;quot;leftPoint&amp;quot;: 653, &amp;quot;recordId&amp;quot;: 972893, &amp;quot;award&amp;quot;: &amp;quot; &amp;quot; } }</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;">last_cnt</td> <td style="text-align: left;">int</td> <td>库存剩余数量</td> </tr> <tr> <td style="text-align: left;">leftPoint</td> <td style="text-align: left;">int</td> <td>库存剩余数量</td> </tr> <tr> <td style="text-align: left;">recordId</td> <td style="text-align: left;">int</td> <td>兑换记录ID</td> </tr> <tr> <td style="text-align: left;">award</td> <td style="text-align: left;">string</td> <td>发奖详情</td> </tr> </tbody> </table> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML