中升GO想用车API接口
<h2>整体概要说明</h2>
<p>中升GO与想用车系统数据之间的API对接，中升GO用户可通过购买优惠券、积分抵扣的方式在想用车小程序进行租车。
若涉及金额传值则单位取分（若金额为100元传参应为10000）</p>
<h2>1. 购买优惠券 - 获取车系名称接口</h2>
<h3>简要概述</h3>
<p>中升GO新增优惠券时，通过此接口选取想用车提供的车系名称进行设置。</p>
<h5>接口提供方：想用车</h5>
<h5>接口调用方：中升GO</h5>
<hr />
<h4>请求URL</h4>
<ul>
<li>测试地址： <code>待定</code></li>
<li>正式地址： <code>待定</code></li>
</ul>
<hr />
<h4>请求方式</h4>
<ul>
<li>POST</li>
</ul>
<h4>数据格式</h4>
<ul>
<li>默认即可</li>
</ul>
<hr />
<h4>出参参考报文</h4>
<pre><code> {
&quot;code&quot;:0,
&quot;data&quot;: {
&quot;productionList&quot;:[
{&quot;id&quot;:&quot;1729187868641480&quot;,&quot;name&quot;:&quot;宝马X1&quot;},
{&quot;id&quot;:&quot;1729187868641480&quot;,&quot;name&quot;:&quot;宝马X1&quot;}
{&quot;id&quot;:&quot;1729187868641480&quot;,&quot;name&quot;:&quot;宝马X1&quot;}
]
},
&quot;message&quot;: &quot;操作成功&quot;
} </code></pre>
<hr />
<h2>2. 购买优惠券 - 优惠券信息查询接口</h2>
<h3>简要概述</h3>
<p>中升GO用户购买优惠券后，想用车系统调用当前接口获取相关数据进行下单租车。</p>
<h5>接口提供方：中升GO</h5>
<h5>接口调用方：想用车</h5>
<hr />
<h4>请求URL</h4>
<ul>
<li>测试地址： <code>待定</code></li>
<li>
<h2>正式地址： <code>待定</code></h2>
<h4>请求数据</h4>
</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>字段描述</th>
<th>备注<div style="width: 180pt"></th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">couponId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>优惠劵ID</td>
<td>中升GO优惠券iD,用户下单后通过该字段向中升GO传递优惠券使用状态</td>
</tr>
</tbody>
</table>
<h4>入参参考报文</h4>
<pre><code> {
&quot;couponId&quot;:&quot;1729187868641480&quot;
} </code></pre>
<h5>出参参考报文</h5>
<ul>
<li>
<p>成功</p>
<pre><code>{
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;status&quot;: &quot;success&quot;,
&quot;productionId&quot;: &quot;1729187868641480&quot;,
&quot;city&quot;: &quot;大连市&quot;,
&quot;days&quot;: &quot;3&quot;,
&quot;money&quot;: &quot;120000&quot;
},
&quot;message&quot;: &quot;操作成功&quot;
}</code></pre>
</li>
<li>
<p>失败</p>
<pre><code>{
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;status&quot;: &quot;fail&quot;,
&quot;reason&quot;:&quot;当前优惠券已失效&quot;
},
&quot;message&quot;: &quot;操作成功&quot;
}
</code></pre>
</li>
</ul>
<hr />
<h2>3. 购买优惠券 - 优惠券核销接口</h2>
<h3>简要概述</h3>
<p>中升GO用户在想用车小程序下单支付成功后，调用中升GO接口进行核销操作</p>
<h5>接口提供方：中升GO</h5>
<h5>接口调用方：想用车</h5>
<hr />
<h2>4. 积分抵扣 - 积分查询接口</h2>
<h3>简要概述</h3>
<p>中升GO用户在想用车小程序租车时，调用此接口获取用户在中升GO的积分，判断是否可以进行租车。</p>
<h5>接口提供方：中升GO</h5>
<h5>接口调用方：想用车</h5>
<hr />
<h4>请求URL</h4>
<ul>
<li>测试地址： <code>待定</code></li>
<li>正式地址： <code>待定</code></li>
</ul>
<hr />
<h4>请求数据</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>字段描述</th>
<th>备注<div style="width: 180pt"></th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>手机号码</td>
<td>-</td>
</tr>
</tbody>
</table>
<h4>入参参考报文</h4>
<pre><code> {
&quot;phone&quot;:&quot;15812345678&quot;
} </code></pre>
<h5>出参参考报文</h5>
<ul>
<li>
<p>成功</p>
<pre><code>{
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;status&quot;: &quot;success&quot;,
&quot;point&quot;:&quot;12500&quot;
},
&quot;message&quot;: &quot;操作成功&quot;
}</code></pre>
</li>
<li>
<p>失败</p>
<pre><code>{
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;status&quot;: &quot;fail&quot;,
&quot;reason&quot;:&quot;用户不存在&quot;
},
&quot;message&quot;: &quot;操作成功&quot;
}
</code></pre>
<hr />
</li>
</ul>
<h2>5. 积分抵扣 - 积分变更接口</h2>
<h3>简要概述</h3>
<p>中升GO用户在想用车小程序下单支付成功/取消订单后，调用此接口扣除/返还用户在中升GO的积分。</p>
<h5>接口提供方：中升GO</h5>
<h5>接口调用方：想用车</h5>
<hr />
<h4>请求URL</h4>
<ul>
<li>测试地址： <code>待定</code></li>
<li>
<h2>正式地址： <code>待定</code></h2>
<h4>请求数据</h4>
</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>字段描述</th>
<th>备注<div style="width: 180pt"></th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>变更类型</td>
<td>WAIT_TO_USE - 预订成功(扣减相应积分)<br>CANCELED - 取消订单(返还相应积分)</td>
</tr>
<tr>
<td style="text-align: left;">orderId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>订单id</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>手机号码</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">point</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>扣减积分</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">money</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>抵扣金额</td>
<td>单位/分，1元=100</td>
</tr>
</tbody>
</table>
<h4>入参参考报文</h4>
<pre><code> {
&quot;type&quot;:&quot;WAIT_TO_USE&quot;,
&quot;orderId&quot;:&quot;1729187868641480&quot;,
&quot;phone&quot;: &quot;15812345678&quot;,
&quot;point&quot;: &quot;800&quot;,
&quot;money&quot;:&quot;8000&quot;
} </code></pre>
<h5>出参参考报文</h5>
<ul>
<li>
<p>成功</p>
<pre><code>{
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;status&quot;: &quot;success&quot;
},
&quot;message&quot;: &quot;操作成功&quot;
}</code></pre>
</li>
<li>
<p>失败</p>
<pre><code>{
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;status&quot;: &quot;fail&quot;,
&quot;reason&quot;:&quot;用户不存在&quot;
},
&quot;message&quot;: &quot;操作成功&quot;
}
</code></pre>
<hr />
</li>
</ul>