加积分接口
<h3>简要描述:</h3>
<ul>
<li>加积分接口(该接口需要签名)</li>
<li>积分托管珊瑚,才需要用这个接口向珊瑚请求加积分</li>
<li>可设置加积分二次确认安全校验回调接口,若设置了,则会调用回调接口确认订单是否合法。默认需要设置该接口,若不设置,有可能会有安全问题。具体可见<a href="https://www.showdoc.com.cn/529145770284919/9574402675376224">加积分二次回调接口</a>
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=7337b2a8058aeda47b4b92430413b5e5&file=file.png" alt="" /></li>
</ul>
<h3>请求 URL</h3>
<ul>
<li><code>/ext/mall/addPoint</code></li>
</ul>
<h3>请求方式</h3>
<ul>
<li>POST</li>
</ul>
<h3>querystring 参数</h3>
<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>
<h3>requestBody 参数</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</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 style="text-align: left;">账号id</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 style="text-align: left;">设备ID ,无设备ID可填account_id</td>
</tr>
<tr>
<td style="text-align: left;">coin_num</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">加积分值</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 style="text-align: left;">此次加积分记录的订单id,需保证在所有加积分记录中唯一</td>
</tr>
<tr>
<td style="text-align: left;">desc</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">加积分的描述,会展示在积分记录中,包含中文的值,在签名的时候需要encode</td>
</tr>
</tbody>
</table>
<h3>返回示例</h3>
<pre><code class="language-json">{
ret: 0,
msg: success',
data: {
left_coin: 200,
order_id: 'xxxx-xxxx'
}
}</code></pre>
<h3>返回参数说明</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">ret</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">成功 0, 失败 非0</td>
</tr>
<tr>
<td style="text-align: left;">left_coin</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">剩余积分值</td>
</tr>
<tr>
<td style="text-align: left;">order_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">透传请求参数 order_id</td>
</tr>
</tbody>
</table>
<h3>备注</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">code</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">7014</td>
<td style="text-align: left;">该接口需要联系运营人员开启权限</td>
</tr>
<tr>
<td style="text-align: left;">10001</td>
<td style="text-align: left;">未设置加积分安全校验接口</td>
</tr>
<tr>
<td style="text-align: left;">10002</td>
<td style="text-align: left;">调用安全接口失败</td>
</tr>
<tr>
<td style="text-align: left;">10003</td>
<td style="text-align: left;">订单不合法</td>
</tr>
</tbody>
</table>
<ul>
<li>更多返回错误代码请看<a href="https://www.showdoc.com.cn/1procedure2develop/3696800772455518">错误代码描述</a></li>
</ul>