接口文档

接口文档


立即购买门票

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>立即购买门票</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://xx.com/api/shop/buyScenicSpotTicket</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;">ticket_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>sku的id</td> </tr> <tr> <td style="text-align: left;">date</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>日期</td> </tr> <tr> <td style="text-align: left;">num</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>数量</td> </tr> <tr> <td style="text-align: left;">traveler_ids</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>出现人id 1,2,3</td> </tr> <tr> <td style="text-align: left;">receiver_realname</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>联系人名字</td> </tr> <tr> <td style="text-align: left;">receiver_mobile</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>联系人手机</td> </tr> <tr> <td style="text-align: left;">use_gold</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>是否使用书币</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{ &amp;quot;code&amp;quot;: 200, &amp;quot;data&amp;quot;: { &amp;quot;id&amp;quot;: 13, &amp;quot;order_sn&amp;quot;: &amp;quot;X20240428141459AIAGC&amp;quot;, &amp;quot;user_id&amp;quot;: 48724, &amp;quot;product_amount&amp;quot;: &amp;quot;200.00&amp;quot;, &amp;quot;product_gold&amp;quot;: 0, &amp;quot;fee_amount&amp;quot;: &amp;quot;0.00&amp;quot;, &amp;quot;fee_gold&amp;quot;: 0, &amp;quot;order_amount&amp;quot;: &amp;quot;200.00&amp;quot;, &amp;quot;order_gold&amp;quot;: 0, &amp;quot;coupon_id&amp;quot;: 0, &amp;quot;coupon_amount&amp;quot;: &amp;quot;0.00&amp;quot;, &amp;quot;coupon_gold&amp;quot;: 0, &amp;quot;pay_amount&amp;quot;: &amp;quot;0.00&amp;quot;, &amp;quot;pay_gold&amp;quot;: 0, &amp;quot;refund_amount&amp;quot;: &amp;quot;0.00&amp;quot;, &amp;quot;refund_gold&amp;quot;: 0, &amp;quot;refund_status&amp;quot;: 1, &amp;quot;pay_status&amp;quot;: 1, &amp;quot;payment&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;pay_sn&amp;quot;: null, &amp;quot;pay_time&amp;quot;: 0, &amp;quot;add_time&amp;quot;: 1714284899, &amp;quot;order_status&amp;quot;: 0, &amp;quot;receiver_realname&amp;quot;: &amp;quot;王五&amp;quot;, &amp;quot;receiver_mobile&amp;quot;: &amp;quot;15757855090&amp;quot;, &amp;quot;summary&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;order_status_name&amp;quot;: &amp;quot;待付款&amp;quot;, &amp;quot;pay_status_name&amp;quot;: &amp;quot;已支付&amp;quot;, &amp;quot;payment_name&amp;quot;: &amp;quot;未知&amp;quot;, &amp;quot;order_id&amp;quot;: 13, &amp;quot;ticket_list&amp;quot;: [ { &amp;quot;order_id&amp;quot;: 13, &amp;quot;user_id&amp;quot;: 48724, &amp;quot;ticket_id&amp;quot;: 4, &amp;quot;ticket_name&amp;quot;: &amp;quot;千岛湖中心湖区门票+千岛湖伯爵号豪华游轮票(含商务套餐)成人票-09:00开航&amp;quot;, &amp;quot;scenic_spot_id&amp;quot;: 1, &amp;quot;scenic_spot_name&amp;quot;: &amp;quot;千岛湖&amp;quot;, &amp;quot;scenic_spot_cover&amp;quot;: &amp;quot;/scenic_spot/cover/qdh.jpg&amp;quot;, &amp;quot;date&amp;quot;: &amp;quot;2024-05-10&amp;quot;, &amp;quot;gold&amp;quot;: 0, &amp;quot;price&amp;quot;: &amp;quot;200.00&amp;quot;, &amp;quot;market_price&amp;quot;: &amp;quot;300.00&amp;quot;, &amp;quot;num&amp;quot;: 1, &amp;quot;status&amp;quot;: 2, &amp;quot;status_name&amp;quot;: &amp;quot;退款中&amp;quot; } ], &amp;quot;traveler_list&amp;quot;: [ { &amp;quot;name&amp;quot;: &amp;quot;zhangsan&amp;quot;, &amp;quot;mobile&amp;quot;: &amp;quot;15757855090&amp;quot;, &amp;quot;id_type&amp;quot;: &amp;quot;id_card&amp;quot;, &amp;quot;id_type_name&amp;quot;: &amp;quot;身份证&amp;quot;, &amp;quot;id_no&amp;quot;: &amp;quot;330825199401221111&amp;quot; } ] }, &amp;quot;message&amp;quot;: &amp;quot;2024-05-07 14:30:12 exec_time:11.6697 api/shop/getScenicSpotTicketOrderDetail&amp;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;">ticket_list.status</td> <td style="text-align: left;">int</td> <td>商品对象里的status表示退款状态,1表示可申请退款,大于1则不可申请退款。1-正常;2-退款中;3-退款完成</td> </tr> <tr> <td style="text-align: left;">product_amount</td> <td style="text-align: left;">int</td> <td>商品总金额</td> </tr> <tr> <td style="text-align: left;">fee_amount</td> <td style="text-align: left;">int</td> <td>运费</td> </tr> <tr> <td style="text-align: left;">order_amount</td> <td style="text-align: left;">int</td> <td>订单总金额</td> </tr> <tr> <td style="text-align: left;">pay_amount</td> <td style="text-align: left;">int</td> <td>现金支付金额</td> </tr> <tr> <td style="text-align: left;">pay_gold</td> <td style="text-align: left;">int</td> <td>书币抵扣</td> </tr> <tr> <td style="text-align: left;">refund_amount</td> <td style="text-align: left;">int</td> <td>现金退款金额</td> </tr> <tr> <td style="text-align: left;">refund_gold</td> <td style="text-align: left;">int</td> <td>书币退款</td> </tr> <tr> <td style="text-align: left;">order_status</td> <td style="text-align: left;">int</td> <td>状态0-待支付;10-待发货;20-已发货;30-已完成;40-已取消;</td> </tr> <tr> <td style="text-align: left;">refund_status</td> <td style="text-align: left;">int</td> <td>退款状态:0-没有退款;1-有退款</td> </tr> <tr> <td style="text-align: left;">order_sn</td> <td style="text-align: left;">int</td> <td>订单编号</td> </tr> </tbody> </table> <h5>备注</h5> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML