对接前必读
<ul>
<li>测试环境地址为: <a href="http://movieapi2-test.taototo.cn/">http://movieapi2-test.taototo.cn/</a> </li>
<li>
<p>正式环境地址为:(https)<a href="http://movieapi2.pintoto.cn/">http://movieapi2.pintoto.cn/</a> </p>
</li>
<li>
<p>线上拉取频率最大:1200/分钟</p>
</li>
<li>
<p>测试appKey: 10000000000</p>
</li>
<li>
<p>测试appSecret: 25f9e794323b453885f5181f1b624d0b</p>
</li>
<li>
<p>所有接口均需要签名, 详情请看[基本参数及校验]</p>
</li>
<li>入参方式: Content-Type:application/x-www-form-urlencoded</li>
</ul>
<h3>关于业务流程的模拟</h3>
<p>测试环境没有真实的商家在报价和出票,因此需要开发者自行模拟竞价、出票、同步取票码、结算、订单关闭5个事件。
模拟方式为:
1.开发者调用【回调流程测试】对应的5个接口;
2.服务方系统接收到回调请求会对所要模拟的订单号进行对应的动作触发;
3.开发者配置的回调接收地址会收到回调响应内容;
因回调流程测试会改变被操作的订单号对应的状态,一张订单重复模拟同一个回调事件无效。
线上正式环境对应的这5个事件是系统根据业务实际情况自然流转进行的,不需要开发者进行模拟。
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/fcd070ea03600fe615ee0e9cb57297e1" alt="" />
<strong>4. 回调事件触发后, 接入方需要在接口返回一个成功标识, (重要)</strong></p>
<pre><code>{
&quot;success&quot;: true,
&quot;message&quot;: &quot;请求成功&quot;,
&quot;code&quot;: 200
}
</code></pre>
<p><strong>5. 数据拉取建议</strong>
线上拉取频率限制:1200/分钟
基础数据根据接入方自己业务需求,自行选择是否存入数据库,如果需要入库,建议数据更新时间如下:</p>
<ul>
<li>城市,地区数据 一天更新一次</li>
<li>影院,影片数据 一天更新一次</li>
<li>排期数据 一小时更新一次</li>
<li>座位数据根据排期实时获取
(注意:所有的数据更新时请全量更新)</li>
</ul>
<h3>关于影票费用的结算</h3>
<p>开发者使用接口下单之前,服务方仅提供市场参考价(对标淘票票),即“场次排期”接口对应的netPrice响应字段。个别场次有价格分区,请根据[场次排期接口]的scheduleArea分区列表进行定价参考。
实际出票成本(结算时的扣款金额)以WAIT_TICKET回调事件返回的“orderPrice”为准。开发者也可以任意时候通过订单查询接口获知票价结算成本(wait_ticket事件之后才有该数值)。
订单服务方提供的影票成本价已包含运营费用,在订单提交之后预先冻结余额中的影票市场价原价。影片上映2小时后结算实际的影票成本并释放冻结金额。</p>