卡券按产品库存提取
<h5>简要描述</h5>
<ul>
<li>下单sendType为3时,回调,主动查单不返回卡券信息,用户的卡券将放入库存,需要时调用该接口按需要提取。<font color=LightCoral >如出现超时等未知异常,请用相同的参数重新调用该接口获取结果。如果提取失败,drawId可重新提交。</font>
<h5>请求URL</h5></li>
<li><code>http://ip:port/directCardOrder/stockDraw</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
<li>application/json;charset=UTF-8 </li>
</ul>
<h5>请求参数说明</h5>
<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;">drawId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>提取id,如果提取卡券成功,传该参数重复调用将返回相同的卡券信息</td>
</tr>
<tr>
<td style="text-align: left;">num</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>提取数量,最大50。如果drawId已经提取卡券成功,重复调用时,请传相同的数量</td>
</tr>
<tr>
<td style="text-align: left;">productId</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">string</td>
<td>产品id</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(userId+key+requestId +drawId +productId+num )</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
&quot;drawId&quot;:&quot;1818636230825480192&quot;,
&quot;num&quot;:1,
&quot;productId&quot;:&quot;10251&quot;,
&quot;sign&quot;:&quot;bfabeccaf3200120b88c1be315eb30aa&quot;
}</code></pre>
<h5>返回参数说明</h5>
<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;">code</td>
<td style="text-align: left;">Integer</td>
<td>返回结果码,200提取成功,其他提取失败</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">String</td>
<td>返回结果信息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">Map</td>
<td>数据集合,提单成功返回</td>
</tr>
<tr>
<td style="text-align: left;">data. drawId</td>
<td style="text-align: left;">Long</td>
<td>提取id</td>
</tr>
<tr>
<td style="text-align: left;">data.createTime</td>
<td style="text-align: left;">string</td>
<td>提取时间,yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList</td>
<td style="text-align: left;">List</td>
<td>卡券信息</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList.faceValue</td>
<td style="text-align: left;">Integer</td>
<td>面额</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList.account</td>
<td style="text-align: left;">String</td>
<td>卡号(密文) ,可能为空</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList.accountKey</td>
<td style="text-align: left;">String</td>
<td>卡密(密文),可能为空</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList.link</td>
<td style="text-align: left;">String</td>
<td>链接(密文) ,可能为空</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList.validCode</td>
<td style="text-align: left;">String</td>
<td>验证码/激活码 (密文),可能为空</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList.enableEndTime</td>
<td style="text-align: left;">String</td>
<td>有效期,yyyy-MM-dd HH:mm:ss</td>
</tr>
</tbody>
</table>
<p>备注:卡号,卡密,链接,验证码只要返回不为空,即为组合关系。例如卡号和卡密不为空,其他为空则组合关系是卡号+卡密;链接和验证码不为空,其他为空则组合关系是链接+验证码,以次类推。<font color=LightCoral >卡券信息采用的是AES(ECB/PKCS5Padding)对称加密算法(解密的key为提单时签名用的key的前16位字符)</font></p>
<h5>返回示例</h5>
<pre><code>{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;操作成功&quot;,
&quot;data&quot;: {
&quot;drawId&quot;: &quot;1818636230825480192&quot;,
&quot;createTime&quot;: &quot;2024-07-31 21:27:50&quot;,
&quot;cardList&quot;: [
{
&quot;account&quot;: &quot;449/UQ1BYNhLLAjkSky/5A==&quot;,
&quot;accountKey&quot;: &quot;BGg/T79yCqvw6COhk3I/eQ==&quot;,
&quot;faceValue&quot;: &quot;10&quot;
}
]
},
&quot;success&quot;: true
}</code></pre>
<pre><code>{
&quot;code&quot;: 450,
&quot;msg&quot;: &quot;库存不足&quot;,
&quot;success&quot;: false
}
</code></pre>
<p>数据加密与解密</p>
<p>卡券信息采用的是AES(ECB/PKCS5Padding)对称加密算法(解密的key为提单时签名用的key的前16位字符),加密/解密代码段(JAVA版)如下:</p>
<pre><code>/**
* AES加密
* @param data
* @return
* @throws Exception
*/
public static String encrypt(String data, String keyStr) throws Exception {
Cipher cipher = Cipher.getInstance(&quot;AES/ECB/PKCS5Padding&quot;);
SecretKeySpec key = new SecretKeySpec(keyStr.getBytes(&quot;UTF-8&quot;), &quot;AES&quot;);
cipher.init(1, key);
return (new BASE64Encoder()).encode(cipher.doFinal(data.getBytes(&quot;UTF-8&quot;)));
}
/**
* AES解密
* @param data
* @return
* @throws Exception
*/
public static String decrypt(String base64Data, String keyStr) throws Exception {
Cipher cipher = Cipher.getInstance(&quot;AES/ECB/PKCS5Padding&quot;);
SecretKeySpec key = new SecretKeySpec(keyStr.getBytes(&quot;UTF-8&quot;), &quot;AES&quot;);
cipher.init(2, key);
return new String(cipher.doFinal((new BASE64Decoder()).decodeBuffer(base64Data)));
}</code></pre>
<ul>
<li>错误码</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">错误码</th>
<th style="text-align: left;">注释</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">200</td>
<td style="text-align: left;">提取成功</td>
</tr>
<tr>
<td style="text-align: left;">505</td>
<td style="text-align: left;">提取失败</td>
</tr>
<tr>
<td style="text-align: left;">400</td>
<td style="text-align: left;">参数错误(提取失败)</td>
</tr>
<tr>
<td style="text-align: left;">412</td>
<td style="text-align: left;">白名单校验失败((提取失败))</td>
</tr>
<tr>
<td style="text-align: left;">450</td>
<td style="text-align: left;"><font color=LightCoral >库存不足(提取失败)</font></td>
</tr>
<tr>
<td style="text-align: left;">422</td>
<td style="text-align: left;">验签失败(提取失败,请检查加签参数与顺序是否正确)</td>
</tr>
<tr>
<td style="text-align: left;">500</td>
<td style="text-align: left;">服务异常(人工确认或重新提交,请检查请求方式,参数格式,类型是否正确)</td>
</tr>
</tbody>
</table>
<ul>
<li>备注:无</li>
</ul>