守兔开放平台api

供合作方调用


快出下单api

<p>流程说明: </p> <ul> <li>通过此api下单, 必传回调地址,且接入方需保证回调地址稳定可用。 下单后, 一段时间内将以回调的方式通知订单竞价后的价格</li> <li> <p>成功出票时,快出单将直接返回取票码。</p> </li> <li> <p>特殊情况,若取票码有误,更新取票码的同时也会根据此回调地址通知,并传入新取票码,接入方自行存储取票码。此时可通知用户查看取票码。</p> </li> <li> <p>因影院场次临时变更,等特殊情况导致订单关闭, 将通过此回调地址通知接入方, 接入方须自行处理给用户退款并关闭订单等操作。</p> </li> <li>详情请看【回调api】接口</li> <li>出票事件顺序:TICKET_SUCCESS-&gt;RDER_FINISH</li> </ul> <h5>请求URL</h5> <ul> <li><code>api/order/create-soon-order</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> <li>入参方式: Content-Type:application/x-www-form-urlencoded</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;">showId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>排期的showId,由影院接口得来</td> </tr> <tr> <td style="text-align: left;">seat</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>用户所选的座位,例:1排1座,1排2座 以英文的逗号 &quot; , &quot;隔开。 如果座位是情侣座,请传入 : 1排1座(情侣座),1排2座(情侣座)</td> </tr> <tr> <td style="text-align: left;">reservedPhone</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>下单时预留的手机号,快出单下单必传此参数</td> </tr> <tr> <td style="text-align: left;">thirdOrderId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>接入方的订单号, 接入方须保证此订单号唯一性</td> </tr> <tr> <td style="text-align: left;">notifyUrl</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>回调地址,各个场景发生时,将通过此地址通知接入方,详情请看【回调api】</td> </tr> <tr> <td style="text-align: left;">acceptChangeSeat</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>是否允许调座,1-允许,0-不允许</td> </tr> <tr> <td style="text-align: left;">seatId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>座位接口的seatId字段, 如果有多个,则以竖线分割</td> </tr> <tr> <td style="text-align: left;">seatNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>座位接口的seatNo字段,如果有多个,则以竖线分割</td> </tr> <tr> <td style="text-align: left;">netPrice</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>所下单所有座位的市场总价<code>单位:分</code>,不可随意乱传,必须是真实价格,如座位有分区定价,也许一一计算后得到总价,否则自动出票失败。<code>由于场次价格延迟问题,有可能造成场次价格和最终价格不一致,此时会出票失败。</code></td> </tr> <tr> <td style="text-align: left;">area</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>座位接口的area字段(若没有值请用空字符串或0代替) ,要与下单座位对应(下单几个座位就有几个area),多个 则以竖线分割,<code>此字段必传才可调用秒出</code></td> </tr> <tr> <td style="text-align: left;">testType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>仅当为调用测试环境时候,此字段有用, 可模拟快出票结果。 <code>201 正在出票中结果</code> <code>500出票失败结果</code></td> </tr> </tbody> </table> <p><code>注1: 仅当下单影院支持快出票下单时,此接口才会正常生效。</code></p> <p><code>注2: 快出票模式,是实际使用影院接口出票,无退款接口,故在正式环境下的快出票单,出票成功后无法退款, 请谅解。</code></p> <p><code>注3: (重要) 不用模拟200,目前测试200和201都是返回的201,然后会回调200的结果到下单填写的回调地址</code></p> <pre><code> 1.当出票成功时候,会直接返回取票码,此时不再另外进行回调,接入方需直接处理自身出票业务逻辑。 可用[testType] = 200 来模拟。 2.当出票失败时,可能参数有误、价格错误、或者影院排期变动,会直接返回出票失败,此时不再另外进行回调,接入方需直接处理自身退款业务逻辑。 可用[testType] = 500 来模拟。 3. 当返回结果为出票中时,系统会不断重试尝试出票,此时,出票成功、出票失败都会进行回调。原因是影院可能卡单,20分钟后如无结果,也会进行回调。 可用[testType] = 201 来模拟。</code></pre> <h5>请求示例</h5> <p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=fdb6e1753eb77b1eecdf1d456a835452&amp;amp;file=file.png" alt="" /></p> <h5>返回示例</h5> <pre><code>{     &amp;quot;code&amp;quot;: 200,     &amp;quot;message&amp;quot;: &amp;quot;操作成功&amp;quot;,     &amp;quot;data&amp;quot;: {         &amp;quot;third_order_id&amp;quot;: &amp;quot;202210101623A144&amp;quot;,         &amp;quot;ticket&amp;quot;: &amp;quot;出票中&amp;quot;,         &amp;quot;ticketStatus&amp;quot;: 201,         &amp;quot;order_id&amp;quot;: &amp;quot;20230316093608100000000005369350786&amp;quot;     },     &amp;quot;success&amp;quot;: true } </code></pre> <h5>备注</h5> <p>取票码截取,去掉中文, let newCode = value.replace(/([^\u0000-\u00FF])/g, ''); //中文替换为空 newCode = newCode.replace(/:/g, ''); //冒号替换为空</p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML