立即购买- 确定订单
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>立即购买- 确定订单</li>
<li>根据skuID和用户ID得到用户当前可用积分、可用优惠券列表、可用优惠券的数量、不可用优惠券列表、不可用优惠券的数量、SKU商品信息，积分抵扣配置信息。</li>
</ul>
<pre><code class="language-css">请求头中需带上TokenValue字段，传参接收到的token值,用于用户验证</code></pre>
<h5>请求URL</h5>
<ul>
<li><code>/api/v1/order/buy_order</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </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;">jsonstr</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请求字符串</td>
</tr>
<tr>
<td style="text-align: left;">token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>token密钥</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">jsonstr参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">user_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;">goods_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商品ID (20240826新增)</td>
</tr>
<tr>
<td style="text-align: left;">spec_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>规格ID (20240826新增)</td>
</tr>
<tr>
<td style="text-align: left;">spec_number</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>规格数量 (20240826新增)</td>
</tr>
</tbody>
</table>
<h5>成功返回示例</h5>
<pre><code>{
&quot;state&quot;: &quot;1&quot;,
&quot;msg&quot;: &quot;获取成功&quot;,
&quot;usable_coupon&quot;: [{
&quot;id&quot;: 1,
&quot;user_id&quot;: 100000,
&quot;status&quot;: 1,
&quot;failure_time&quot;: &quot;2023-12-03 17:20:11&quot;,
&quot;remark&quot;: &quot;后台发放,操作账号：admin&quot;,
&quot;coupon_name&quot;: &quot;99减50元通用券&quot;,
&quot;coupon_type&quot;: 1,
&quot;less_money&quot;: 50,
&quot;min_money&quot;: 99
},{
&quot;id&quot;: 1,
&quot;user_id&quot;: 100000,
&quot;status&quot;: 1,
&quot;failure_time&quot;: &quot;2023-12-03 17:20:11&quot;,
&quot;remark&quot;: &quot;后台发放,操作账号：admin&quot;,
&quot;coupon_name&quot;: &quot;99减50元通用券&quot;,
&quot;coupon_type&quot;: 1,
&quot;less_money&quot;: 50,
&quot;min_money&quot;: 99
}
],
&quot;usable_count&quot;:5,
&quot;unusable_coupon&quot;: [{
&quot;id&quot;: 1,
&quot;user_id&quot;: 100000,
&quot;status&quot;: 1,
&quot;failure_time&quot;: &quot;2023-12-03 17:20:11&quot;,
&quot;remark&quot;: &quot;后台发放,操作账号：admin&quot;,
&quot;coupon_name&quot;: &quot;99减50元通用券&quot;,
&quot;coupon_type&quot;: 1,
&quot;less_money&quot;: 50,
&quot;min_money&quot;: 99
},{
&quot;id&quot;: 1,
&quot;user_id&quot;: 100000,
&quot;status&quot;: 1,
&quot;failure_time&quot;: &quot;2023-12-03 17:20:11&quot;,
&quot;remark&quot;: &quot;后台发放,操作账号：admin&quot;,
&quot;coupon_name&quot;: &quot;99减50元通用券&quot;,
&quot;coupon_type&quot;: 1,
&quot;less_money&quot;: 50,
&quot;min_money&quot;: 99
}
],
&quot;unusable_count&quot;:5,
&quot;config_integral_rate&quot;:&quot;10&quot;,
&quot;config_integral_scale&quot;:&quot;100&quot;,
&quot;usable_jf&quot;:605,
&quot;deduct_money&quot;:5,
&quot;deduct_jf&quot;:500,
&quot;data&quot;: [{
&quot;id&quot;: 880,
&quot;user_id&quot;: 100000,
&quot;goods_id&quot;: 1000,
&quot;spec_id&quot;: 2,
&quot;spec_number&quot;: 1,
&quot;store_name&quot;: &quot;博邦锂电&quot;,
&quot;goods_title&quot;: &quot;原装充电器 2.8A/4.0A/5.2A适配平台所有系列充电&quot;,
&quot;spec_img&quot;: &quot;http://file.balin.com/goods/202312/20231204095551176.jpg&quot;,
&quot;spec_value&quot;: &quot;5.2A&quot;,
&quot;original_price&quot;: 99.00,
&quot;current_price&quot;: 90.00,
&quot;spec_store&quot;: 6652,
},
{
&quot;id&quot;: 880,
&quot;user_id&quot;: 100000,
&quot;goods_id&quot;: 1000,
&quot;spec_id&quot;: 2,
&quot;spec_number&quot;: 1,
&quot;store_name&quot;: &quot;博邦锂电&quot;,
&quot;goods_title&quot;: &quot;原装充电器 2.8A/4.0A/5.2A适配平台所有系列充电&quot;,
&quot;spec_img&quot;: &quot;http://file.balin.com/goods/202312/20231204095551176.jpg&quot;,
&quot;spec_value&quot;: &quot;5.2A&quot;,
&quot;original_price&quot;: 99.00,
&quot;current_price&quot;: 90.00,
&quot;spec_store&quot;: 6652,
}
]
}</code></pre>
<h5>失败返回示例</h5>
<pre><code> {
&quot;state&quot;: &quot;-999&quot;,
&quot;msg&quot;: &quot;拒绝访问：你没有权限&quot;,
&quot;data&quot;: &quot;&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;">state</td>
<td style="text-align: left;">string</td>
<td>状态 1为成功，其他为失败</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;">usable_coupon</td>
<td style="text-align: left;">string</td>
<td>可用优惠券列表</td>
</tr>
<tr>
<td style="text-align: left;">usable_count</td>
<td style="text-align: left;">int</td>
<td>可用优惠券数量</td>
</tr>
<tr>
<td style="text-align: left;">unusable_coupon</td>
<td style="text-align: left;">string</td>
<td>不可用优惠券列表</td>
</tr>
<tr>
<td style="text-align: left;">unusable_count</td>
<td style="text-align: left;">int</td>
<td>不可用优惠券数量</td>
</tr>
<tr>
<td style="text-align: left;">config_integral_rate</td>
<td style="text-align: left;">string</td>
<td>商城订单使用积分百分比：N%</td>
</tr>
<tr>
<td style="text-align: left;">config_integral_scale</td>
<td style="text-align: left;">string</td>
<td>商城订单积分与金额兑换比例：N积分=1元</td>
</tr>
<tr>
<td style="text-align: left;">usable_jf</td>
<td style="text-align: left;">int</td>
<td>用户当前可用积分数量</td>
</tr>
<tr>
<td style="text-align: left;">deduct_money</td>
<td style="text-align: left;">decimal</td>
<td>可抵扣金额</td>
</tr>
<tr>
<td style="text-align: left;">deduct_jf</td>
<td style="text-align: left;">int</td>
<td>可抵扣积分</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">string</td>
<td>购物车SKU列表</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">【usable_coupon】、【unusable_coupon】参数说明</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">int</td>
<td>优惠券领取ID</td>
</tr>
<tr>
<td style="text-align: left;">user_id</td>
<td style="text-align: left;">int</td>
<td>用户ID</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">int</td>
<td>状态（1未使用 2已使用 3已过期）</td>
</tr>
<tr>
<td style="text-align: left;">failure_time</td>
<td style="text-align: left;">datetime</td>
<td>失效时间</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">string</td>
<td>备注</td>
</tr>
<tr>
<td style="text-align: left;">coupon_name</td>
<td style="text-align: left;">string</td>
<td>优惠券名称</td>
</tr>
<tr>
<td style="text-align: left;">coupon_type</td>
<td style="text-align: left;">int</td>
<td>优惠券类型（1通用券 2商品券 3分类券）</td>
</tr>
<tr>
<td style="text-align: left;">less_money</td>
<td style="text-align: left;">decimal</td>
<td>优惠券面值</td>
</tr>
<tr>
<td style="text-align: left;">min_money</td>
<td style="text-align: left;">decimal</td>
<td>优惠券最低消费</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">【data】中的参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">int</td>
<td>ID</td>
</tr>
<tr>
<td style="text-align: left;">user_id</td>
<td style="text-align: left;">int</td>
<td>用户ID</td>
</tr>
<tr>
<td style="text-align: left;">goods_id</td>
<td style="text-align: left;">int</td>
<td>商品ID</td>
</tr>
<tr>
<td style="text-align: left;">spec_id</td>
<td style="text-align: left;">int</td>
<td>规格ID</td>
</tr>
<tr>
<td style="text-align: left;">spec_number</td>
<td style="text-align: left;">int</td>
<td>购物车数量</td>
</tr>
<tr>
<td style="text-align: left;">store_name</td>
<td style="text-align: left;">string</td>
<td>商户名</td>
</tr>
<tr>
<td style="text-align: left;">goods_title</td>
<td style="text-align: left;">string</td>
<td>商品名称</td>
</tr>
<tr>
<td style="text-align: left;">spec_img</td>
<td style="text-align: left;">string</td>
<td>规格图片</td>
</tr>
<tr>
<td style="text-align: left;">spec_value</td>
<td style="text-align: left;">string</td>
<td>规格值</td>
</tr>
<tr>
<td style="text-align: left;">original_price</td>
<td style="text-align: left;">decimal</td>
<td>原价</td>
</tr>
<tr>
<td style="text-align: left;">current_price</td>
<td style="text-align: left;">decimal</td>
<td>现价</td>
</tr>
<tr>
<td style="text-align: left;">spec_store</td>
<td style="text-align: left;">int</td>
<td>库存</td>
</tr>
</tbody>
</table>
<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;">1</td>
<td style="text-align: left;">string</td>
<td>成功</td>
</tr>
<tr>
<td style="text-align: left;">-1</td>
<td style="text-align: left;">string</td>
<td>参数有误</td>
</tr>
<tr>
<td style="text-align: left;">-99</td>
<td style="text-align: left;">string</td>
<td>异常</td>
</tr>
<tr>
<td style="text-align: left;">-999</td>
<td style="text-align: left;">string</td>
<td>拒绝访问：你没有权限</td>
</tr>
<tr>
<td style="text-align: left;">-9999</td>
<td style="text-align: left;">string</td>
<td>token验证失败</td>
</tr>
</tbody>
</table>