电影票API接口及公众号对接H5

公众号接入授权地址：https://hp.nldy​‌‌p.com/api/openplatform/aut
打开地址按照流程进行接入即可，接入后有后台管理

目录

 

1. 概述 3
   1. 请求参数构成 3
   2. 公共请求参数 3
   3. 请求地址 3
   4. 公共返回参数 3
2. 签名 4
   1. 签名算法 4
3. 业务接口 4
   1. getFilmList 获取影片资料 4
      1. 接口 4
      2. 接口说明 4
      3. 请求参数 4
      4. 返回结果 5
   2. getCinema 获取影院 7
      1. 接口 7
      2. 接口说明 7
      3. 请求参数 7
      4. 返回结果 7
   3. getPlan 获取影城排期 8
      1. 接口 8
      2. 接口说明 8
      3. 请求参数 9
      4. 返回结果 9
   4. getPlanDetail 获取影城单个排期详情 11

3.4.1 接口 11

1. 1. 1. 接口说明 11
      2. 请求参数 11
      3. 返回结果 11
   2. getPlanSeat 获取实时座位图 13

3.5.1 接口 13

1. 1. 1. 接口说明 13
      2. 请求参数 13
      3. 返回结果 13
   2. lockSeat 锁座（支持多座区下单） 15

3.6.1 接口 15

1. 1. 1. 接口说明 15
      2. 请求参数 15
      3. 返回结果 16
   2. unLockOrder 释放锁座 16

3.7.1 接口 16

1. 1. 1. 接口说明 17
      2. 请求参数 17
      3. 返回结果 17
   2. sellTicket 售票 17

3.8.1 接口 17

1. 1. 1. 接口说明 17
      2. 请求参数 18
      3. 返回结果 18
   2. getOrderStatus 查询订单状态 18

3.9.1 接口 18

1. 1. 1. 接口说明 18
      2. 请求参数 19
      3. 返回结果 19
2. 退票通知（接入方提供接收地址） 21
3. 错误代码 21

 

 

 

 

 

 

 

1. 概述

 

本文档提供天空之城对外相关的全部接口说明

 

1. 1. 请求参数构成

 

由公共请求参数和业务请求参数组成，公共请求参数见下表，业务请求参数请参考具体接口的参数说明。一个接口    调用请求由公共请求参数和接口业务参数两部分组成。

 

 

1. 1. 公共请求参数

 

名称	类型	是否必须	参数说明	示例
account	String	必须	应用编码。	test
requestTime	String	必须	请求时间	2006-01-02 15:04:05
verifyInfo	String	必须	签名串，见签名算法

 

1. 1. 请求地址

 

测试环境: https://textapi.nldyp.com

 

 

1. 1. 公共返回参数

 

名称	类型	描述	说明
status	Int	返回结果码	0 表示成功
content	String	系统返回描述	结果描述
data	Object 或Array	返回数据	返回的业务结果数据

 

1. 签名

 

1. 1. 签名算法

应用编码、密钥将会按邮件形式发送给第三方 加密规则如下：

请求参数按 ASCII 码顺序升序排序，然后按 key 拼接 value 形式组成待签名串，再拼上分配的密钥，组成真正的待签名串（编码 utf-8）。将待签名串先使用哈希(Sha1)加密算法进行加密，接着将哈希加密过的待签名串进行 Md5 加密算法再进行加密（32 位）,最后的签名结果需转成小写,然后截取签名结果的中间 16 位作为真正的签名。

 

伪代码如下：

1、参数排序：采用参数键值升序排列

2、拼接参数：accounttest_01cinemaId158583requestTime2006-01-02 15:04:05

3、拼接密钥：accounttest_01cinemaId158583requestTime2006-01-02 15:04:05 密钥

4、Sha1 加密：sha1(accounttest_01cinemaId158583requestTime2006-01-02 15:04:05 密钥)

5、Md5 加密：md5(sha1(accounttest_01cinemaId158583requestTime2006-01-02 15:04:05 密钥))

6、转小写:转小写 (md5(sha1(accounttest_01cinemaId158583requestTime2006-01-02 15:04:05 密钥))) 7、再截取中间 16 位