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

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


查兑换记录

<p><strong>简要描述:</strong> </p> <ul> <li>查询用户兑换记录列表(该接口需要签名)</li> <li>近三个月 <strong>请求URL:</strong> </li> <li><code>/ext/mall/getMallExcRecord</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>GET </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;">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> <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> </tbody> </table> <p><strong>返回示例</strong></p> <pre><code>{ &amp;quot;ret&amp;quot;: 0, &amp;quot;data&amp;quot;: [ { &amp;quot;mall_record_id&amp;quot;: 3271, &amp;quot;account_id&amp;quot;: &amp;quot;testaccountid&amp;quot;, &amp;quot;status&amp;quot;: 2, &amp;quot;create_time&amp;quot;: 1603795956, &amp;quot;inventory_order_id&amp;quot;: &amp;quot;b583eecc-0482-4c48-b804-41111e4c37a7&amp;quot;, &amp;quot;point_cost&amp;quot;: 2, &amp;quot;mid&amp;quot;: 47828, &amp;quot;exc_detail&amp;quot;: &amp;quot;coupon无需兑换信息&amp;quot;, &amp;quot;cid&amp;quot;: 1092, &amp;quot;update_time&amp;quot;: 1603795957, &amp;quot;name&amp;quot;: &amp;quot;滴滴打车&amp;quot;, &amp;quot;classify_id&amp;quot;: 5, &amp;quot;icon&amp;quot;: &amp;quot;https://webcdn.m.qq.com/webGmall/1600759374120.png&amp;quot;, &amp;quot;award_delay&amp;quot;: 7, &amp;quot;exc_result&amp;quot;: &amp;quot;https://basicmall.fulu.com/detail?gid=8466eeb2-fc9f-4a52-b889-b43a49661d1a&amp;amp;codeid=EK63gyWJ&amp;quot; }, { &amp;quot;mall_record_id&amp;quot;: 3278, &amp;quot;account_id&amp;quot;: &amp;quot;testaccountid&amp;quot;, &amp;quot;status&amp;quot;: 2, &amp;quot;create_time&amp;quot;: 1603798719, &amp;quot;inventory_order_id&amp;quot;: &amp;quot;aefdca1c-ce3c-41de-a071-8cab46b04d63&amp;quot;, &amp;quot;point_cost&amp;quot;: 2, &amp;quot;mid&amp;quot;: 47829, &amp;quot;exc_detail&amp;quot;: &amp;quot;cdk无需兑换信息&amp;quot;, &amp;quot;cid&amp;quot;: 1109, &amp;quot;update_time&amp;quot;: 1603798720, &amp;quot;name&amp;quot;: &amp;quot;CDK10&amp;quot;, &amp;quot;classify_id&amp;quot;: 8, &amp;quot;icon&amp;quot;: &amp;quot;https://webcdn.m.qq.com/webGmall/1596162791016.png&amp;quot;, &amp;quot;award_delay&amp;quot;: 7, &amp;quot;exc_result&amp;quot;: { &amp;quot;order_id&amp;quot;: &amp;quot;aefdca1c-ce3c-41de-a071-8cab46b04d63&amp;quot;, &amp;quot;cost_count&amp;quot;: 1, &amp;quot;status&amp;quot;: 4, &amp;quot;award_status&amp;quot;: 1, &amp;quot;create_time&amp;quot;: &amp;quot;2020-10-27T11:38:39.000Z&amp;quot;, &amp;quot;award_result&amp;quot;: &amp;quot;AFKDF3VE8GHEC5UU&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;">name</td> <td style="text-align: left;">string</td> <td>奖品名称</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">int</td> <td>发奖状态 1.处理中2 兑换成功 3.扣积分失败 4.未知原因失败 5.成功并且已发奖, 6.发奖失败,已返还积分 7.返还积分失败且发奖失败</td> </tr> <tr> <td style="text-align: left;">create_time</td> <td style="text-align: left;">string</td> <td>创建时间</td> </tr> <tr> <td style="text-align: left;">mall_record_id</td> <td style="text-align: left;">string</td> <td>兑换记录ID</td> </tr> <tr> <td style="text-align: left;">exc_detail</td> <td style="text-align: left;">string</td> <td>发奖信息,用户填写信息,或者classify_id=13的优惠券的跳转链接</td> </tr> <tr> <td style="text-align: left;">icon</td> <td style="text-align: left;">string</td> <td>奖品icon</td> </tr> <tr> <td style="text-align: left;">mid</td> <td style="text-align: left;">int</td> <td>奖品id</td> </tr> <tr> <td style="text-align: left;">classify_id</td> <td style="text-align: left;">int</td> <td>奖品类型ID。4.实物奖品;5.优惠券;8.cdk码;11.微信支付券</td> </tr> <tr> <td style="text-align: left;">exc_result</td> <td style="text-align: left;">string</td> <td>发奖结果。对于自定义商品通过getMallExcRecord获取的exc_result=自定义奖品发奖接口返回的data.award_result_url</td> </tr> <tr> <td style="text-align: left;">award_result</td> <td style="text-align: left;">string</td> <td>发奖结果,cdk码,或领奖链接</td> </tr> </tbody> </table> <p>发奖状态备注:优惠券类型不用发奖,发奖状态不用更新;实物奖品人工发奖,发奖状态人工更新;其他自动发奖,珊瑚系统自动更新发奖状态。</p> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML