电影票接口文档-磐河旅行开放平台

接口地址： http://接口域名/movie/getAllCity

返回格式： json

请求方法： get

请求示例： http://接口域名/movie/getAllCity?appKey=您申请的APPKEY

接口说明：

该接口用于获取全国所有城市数据字典，实际使用中，调用一次保存本地即可。PS: 静态数据，切勿实时调用该接口，每天最多请求10次。(可半年或1年手动更新1次，基本无更新...)

请求参数：

参数名称	类型	必填	说明
appKey	string	是	接口账号appKey

返回参数：

参数名称	类型	说明
cityCode	string	城市代码（其他接口方法的请求参数中需要传入城市的地方，都是传入城市代码）
cityName	string	城市名称
cityPinYin	string	城市拼音
isHot	bool	是否热门城市
initials	string	城市拼音首字母

JSON返回示例 :

{
  "data": [
    {
      "cityCode": "110100",
      "cityName": "北京",
      "cityPinYin": "BeiJing",
      "isHot": true,
      "initials": "B"
    },
    {
      "cityCode": "120100",
      "cityName": "天津",
      "cityPinYin": "TianJin",
      "isHot": false,
      "initials": "T"
    },
    {
      "cityCode": "130100",
      "cityName": "石家庄",
      "cityPinYin": "ShiJiaZhuang",
      "isHot": false,
      "initials": "S"
    },
    。。。
  ],
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/movie/getCityRegions

返回格式： json

请求方法： get/post

请求示例： http://接口域名/movie/getCityRegions?appKey=您申请的APPKEY&cityCode=310100

请求参数：

参数名称	类型	必填	说明
cityCode	string	是	城市代码

返回参数：

参数名称	类型	说明
regionCode	string	区县代码
regionName	string	区县名称

JSON返回示例 :

{
  "data": [
    {
      "regionCode": "171",
      "regionName": "闵行区"
    },
    {
      "regionCode": "172",
      "regionName": "黄浦区"
    },
    {
      "regionCode": "174",
      "regionName": "浦东新区"
    },
    {
      "regionCode": "175",
      "regionName": "宝山区"
    },
    {
      "regionCode": "176",
      "regionName": "嘉定区"
    },
    {
      "regionCode": "177",
      "regionName": "松江区"
    },
    {
      "regionCode": "178",
      "regionName": "杨浦区"
    },
    {
      "regionCode": "179",
      "regionName": "徐汇区"
    },
    {
      "regionCode": "180",
      "regionName": "奉贤区"
    },
    {
      "regionCode": "181",
      "regionName": "金山区"
    },
    {
      "regionCode": "182",
      "regionName": "普陀区"
    },
    {
      "regionCode": "183",
      "regionName": "青浦区"
    },
    {
      "regionCode": "184",
      "regionName": "静安区"
    },
    {
      "regionCode": "185",
      "regionName": "长宁区"
    },
    {
      "regionCode": "186",
      "regionName": "虹口区"
    },
    {
      "regionCode": "1375",
      "regionName": "崇明区"
    }
  ],
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/movie/getFilmList

返回格式： json

请求方法： get

请求示例： http://接口域名/movie/getFilmList?appKey=您申请的APPKEY&orderNo=2020072713232677046416&type=0&pageIndex=1&pageSize=10&keyWord

请求参数：

参数名称	类型	必填	说明
type	int	是	类型：0 热映 / 1 待上映
keyWord	string	是	按关键词搜索模糊搜索影片名称
pageIndex	int	是	页数
pageSize	int	是	条数

返回参数：

参数名称	类型	说明
total	int	查询到的电影总数
filmList	Film[]	影片列表
filmId	string	影片ID
filmCode	string	影片统一编码（暂时用不到）
name	string	影片名称
pic	string	海报URL地址
grade	string	评分
like	int	想看人数
director	string	导演
leading_role	string	主演
publishDate	string	上映日期
duration	int	影片时长分钟
filmTypes	string	影片类型

JSON返回示例 :

{
  "data": {
    "total": 187,
    "filmList": [
      {
        "filmId": "178583",
        "filmCode": "05101292023",
        "name": "碟中谍7：致命清算（上）",
        "pic": "https://gw.alicdn.com/i3/O1CN01pA2ZfY1lGKPFWJi7k_!!6000000004791-0-alipicbeacon.jpg_480x480Q30s150.jpg",
        "grade": "9.5",
        "like": 185128,
        "director": "克里斯托夫·迈考利",
        "leading_role": "汤姆·克鲁斯 海莉·阿特维尔 文·瑞姆斯 西蒙·佩吉 丽贝卡·弗格森 凡妮莎·柯比 亨利·科泽尼",
        "publishDate": "2023-07-14 00:00:00",
        "duration": 164,
        "filmTypes": "动作|惊悚|冒险"
      },
      {
        "filmId": "168155",
        "filmCode": "00103882022",
        "name": "消失的她",
        "pic": "https://gw.alicdn.com/i3/O1CN01X71Co71XyqHDWwfMF_!!6000000002993-0-alipicbeacon.jpg_480x480Q30s150.jpg",
        "grade": "9.6",
        "like": 323127,
        "director": "崔睿  刘翔",
        "leading_role": "朱一龙 倪妮 文咏珊 杜江",
        "publishDate": "2023-06-22 09:00:00",
        "duration": 122,
        "filmTypes": "悬疑|犯罪|剧情"
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/movie/getFilmSchedules

返回格式： json

请求方法： get

请求示例： http://接口域名/movie/getFilmSchedules?appKey=您申请的APPKEY&filmId=176571&cityCode=340100

接口说明：

获取某影片的详情及某城市下的排期日期信息

请求参数：

参数名称	类型	必填	说明
filmId	string	是	影片ID
cityCode	string	是	城市代码

返回参数：

参数名称	类型	说明
filmInfo	FilmInfo	影片信息（对象）
schedules	Schedule[]	排期信息（对象数组）
filmId	string	影片ID
filmCode	string	影片统一编码11位(暂时用不到)
name	string	影片名称
pic	string	海报URL地址
grade	string	评分
like	int	想看人数
director	string	导演
leading_role	string	主演
publishDate	string	上映日期
duration	int	影片时长分钟
filmTypes	string	影片类型
movieArea	string	影片制作地区
language	string	影片语言
intro	string	简介
show_time	string	日期（schedules 对象数组节点下的字段值）

JSON返回示例 :

{
  "data": {
    "filmInfo": {
      "filmId": "176571",
      "filmCode": "00102502023",
      "name": "八角笼中",
      "pic": "https://gw.alicdn.com/i4/O1CN017mWMkN2AEpV9KBFRX_!!6000000008172-0-alipicbeacon.jpg_480x480Q30s150.jpg",
      "grade": "9.3",
      "like": "451957",
      "director": "王宝强",
      "leading_role": "王宝强 陈永胜 史彭元 王迅 张祎曈",
      "publishDate": "2023-07-06 09:00:00",
      "duration": 117,
      "filmTypes": "剧情",
      "movieArea": "中国大陆",
      "language": "汉语普通话",
      "intro": "年度最受期待现实佳作！根据真实事件改编，王宝强诚意打造普通人改写命运之路！电影讲述了向腾辉（王宝强 饰）倾注心血想把当地无人照料的孩子培养成才，这让生活本没有出路的孩子们看到了一丝通向未来的曙光。然而，随着往日的表演视频被爆出，这些“残忍、血腥”的画面刺激了不明真相的人们的神经。一夜之间，舆论开始发酵。向腾辉的生活、孩子们的前途都陷入到人们以善良为名编织的大网中，让 他们难以挣脱，重回泥沼，关于未来，他们的“出路”又将在哪……"
    },
    "schedules": [
      {
        "show_time": "2023-07-18"
      },
      {
        "show_time": "2023-07-19"
      },
      {
        "show_time": "2023-07-20"
      },
      {
        "show_time": "2023-07-21"
      },
      {
        "show_time": "2023-07-23"
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/movie/getCinemaList

返回格式： json

请求方法： get

请求示例： http://接口域名/movie/getCinemaList?appKey=您申请的APPKEY&cityCode=310100&regionCode=176&keyword&pageIndex=1&pageSize=10

请求参数：

参数名称	类型	必填	说明
cityCode	string	是	城市代码(必传)
regionCode	string	否	区县代码
keyword	string	否	搜索影院名称模糊搜索，如：万达
longitude	decimal	否	经度
纬度	decimal	否	纬度
pageIndex	int	是	页码
pageSize	int	是	页大小

返回参数：

参数名称	类型	说明
total	int	搜索到的总影院数
cinemaList	Cinema[]	影院对象数组
cinemaId	string	影院ID
cinemaName	string	影院名称
cityName	string	影院所在城市名称
cinemaAddress	string	影院详细地址
tel	string	影院电话
longitude	decimal	影院经度
latitude	decimal	影院纬度
downPrice	string	影院的最低价格
distanceText	string	用户和影院之间的距离（请求参数未传经纬度时此值忽略）

JSON返回示例 :

{
  "data": {
    "total": 29,
    "cinemaList": [
      {
        "cinemaId": "24736",
        "cinemaName": "上海中影国际影城（嘉定菊园新e街店）",
        "cityName": "上海",
        "cinemaAddress": "嘉定区胜竹路2050号三楼",
        "tel": "021-39510102",
        "longitude": "121.249549",
        "latitude": "31.401735",
        "downPrice": "33.25",
        "distanceText": "960.67km"
      },
      {
        "cinemaId": "1197",
        "cinemaName": "大地影院（上海罗宾森店）",
        "cityName": "上海",
        "cinemaAddress": "嘉定区城中路138号罗宾森广场4楼",
        "tel": "021-59929820 ",
        "longitude": "121.2458708155",
        "latitude": "31.3844768814",
        "downPrice": "44.10",
        "distanceText": "961.96km"
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/movie/getScheduleCinemaList

返回格式： json

请求方法： get

请求示例： http://接口域名/movie/getScheduleCinemaList?appKey=您申请的APPKEY&filmId=176571&cityCode=340100&regionCode=554&keyword&longitude&latitude&pageIndex=1&pageSize=10

接口说明：

获取某影片在某城市近期有排期的影院

请求参数：

参数名称	类型	必填	说明
filmId	string	是	影片ID(必传)
cityCode	string	是	城市代码(必传)
regionCode	string	否	区县代码
keyword	string	否	搜索影院名称模糊搜索，如：万达
longitude	decimal	否	经度
latitude	decimal	否	纬度
date	string	是	指定日期(格式：yyyy-MM-dd，如： 2018-01-01)，不传默认当天
pageIndex	int	是	页码
pageSize	int	是	页大小

返回参数：

参数名称	类型	说明
total	int	搜索到的总影院数
cinemaList	Cinema[]	影院对象数组
cinemaId	string	影院ID
cinemaName	string	影院名称
cityName	string	影院所在城市名称
cinemaAddress	string	影院详细地址
tel	string	影院电话
longitude	decimal	影院经度
latitude	decimal	影院纬度
downPrice	string	影院的最低价格
distanceText	string	用户和影院之间的距离（请求参数未传经纬度时此值忽略）

JSON返回示例 :

{
  "data": {
    "total": 25,
    "cinemaList": [
      {
        "cinemaId": "20153",
        "cinemaName": " UME影城（合肥高新店）",
        "cityName": "合肥",
        "cinemaAddress": "蜀山区长宁大道1888号奥特莱斯3楼",
        "tel": "0551-62553388 ",
        "longitude": "117.11663",
        "latitude": "31.837595",
        "downPrice": "37.90",
        "distanceText": "727.07km"
      },
      {
        "cinemaId": "116060",
        "cinemaName": "中影嘉莱国际影城（奥园4K巨幕店）",
        "cityName": "合肥",
        "cinemaAddress": "蜀山区长江西路奥园城市天地4楼（1楼南门手扶梯旁电梯间电梯可直达4楼影城）",
        "tel": "0551-65857007 ",
        "longitude": "117.167609",
        "latitude": "31.852047",
        "downPrice": "36.10",
        "distanceText": "727.11km"
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/movie/getCinemaFilms

返回格式： json

请求方法： get

请求示例： http://接口域名/movie/getCinemaFilms?appKey=您申请的APPKEY&cinemaId=116060

接口说明：

获取某影院的详细信息及近期排期的影片

请求参数：

参数名称	类型	必填	说明
cinemaId	string	是	影院ID

返回参数：

参数名称	类型	说明
cinemaInfo	Cinema	影院信息（对象类型，详见【获取城市的影院列表】接口响应参数中的cinemaList节点数组数据类型）
filmList	FilmInfo[]	影片列表（对象数组类型，详见【获取影片信息&近期排期】接口响应参数中的filmInfo节点数据类型）

JSON返回示例 :

{
  "data": {
    "cinemaInfo": {
      "cinemaId": "116060",
      "cinemaName": "中影嘉莱国际影城（奥园4K巨幕店）",
      "cityName": "合肥",
      "cinemaAddress": "蜀山区长江西路奥园城市天地4楼（1楼南门手扶梯旁电梯间电梯可直达4楼影城）",
      "tel": "0551-65857007 ",
      "longitude": "117.167609",
      "latitude": "31.852047",
      "downPrice": null,
      "distanceText": null
    },
    "filmList": [
      {
        "filmId": "178583",
        "filmCode": "05101292023",
        "name": "碟中谍7：致命清算（上）",
        "pic": "https://gw.alicdn.com/i3/O1CN01pA2ZfY1lGKPFWJi7k_!!6000000004791-0-alipicbeacon.jpg_480x480Q30s150.jpg",
        "grade": "9.5",
        "like": 185128,
        "director": "克里斯托夫·迈考利",
        "leading_role": "汤姆·克鲁斯 海莉·阿特维尔 文·瑞姆斯 西蒙·佩吉 丽贝卡·弗格森 凡妮莎·柯比 亨利·科泽尼",
        "publishDate": "2023-07-14 00:00:00",
        "duration": 164,
        "filmTypes": "动作|惊悚|冒险",
        "movieArea": "美国",
        "language": "英语",
        "intro": "刷新极限的传奇特工系列火线回归，感受今夏最真实震撼的银幕冒险！特工伊森·亨特（汤姆·克鲁斯饰）和他的IMF小组将开启迄今为止最危险的一次任务：追踪一种会危及全人类性命的新型武器，并阻止其落入坏人之手。与此同时，伊森曾对抗过的黑暗势力也正在卷土重来，整个世界的命运岌岌可危。面对神秘而强大的敌人，他不得不面对选择使命还是至爱的终极抉择。"
      },
      {
        "filmId": "168155",
        "filmCode": "00103882022",
        "name": "消失的她",
        "pic": "https://gw.alicdn.com/i3/O1CN01X71Co71XyqHDWwfMF_!!6000000002993-0-alipicbeacon.jpg_480x480Q30s150.jpg",
        "grade": "9.6",
        "like": 323127,
        "director": "崔睿  刘翔",
        "leading_role": "朱一龙 倪妮 文咏珊 杜江",
        "publishDate": "2023-06-22 09:00:00",
        "duration": 122,
        "filmTypes": "悬疑|犯罪|剧情",
        "movieArea": "中国大陆",
        "language": "汉语普通话",
        "intro": "金牌监制陈思诚继《误杀》系列后又一悬疑力作，朱一龙、倪妮、文咏珊、杜江俊男美女狂飙演技，剧情过山车反转停不下来！何非（朱一龙 饰）的妻子李木子（文咏珊 饰）在结婚周年旅行中离奇消失，在何非苦寻无果之时妻子再次现身，何非却坚持眼前的陌生女人并非妻子，妻子拿出了身份证明进行自证，夫妻二人似乎都有不可告人的秘密，随着金牌律师陈麦（倪妮 饰）介入到这起离奇案件中，更多的谜团慢慢浮现……究竟谁在说谎？端午佳节一起沉浸解谜。"
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/movie/getFilmShowList

返回格式： json

请求方法： get

请求示例： http://接口域名/movie/getFilmShowList?appKey=您申请的APPKEY&cinemaId=116060&filmId=178583&date=2023-07-19

请求参数：

参数名称	类型	必填	说明
cinemaId	string	是	影院ID（必传）
filmId	string	是	影片ID（必传）
date	string	否	日期（可选，默认为返回参数schedules中的第一条日期）

返回参数：

参数名称	类型	说明
showList	FilmShowInfo[]	场次列表（场次对象数组类型，data节点下的字段）
showId	string	场次 id (showList节点数组元素对象中的字段,以下未特殊说明的字段都是showId的兄弟节点字段)
hallName	string	影厅名称
cinemaId	string	影院 id
filmId	string	影片ID
filmCode	string	影片统一编码11位(暂时用不到)
filmName	string	影片名称
duration	int	影片时长分钟
showTime	string	开场时间
stopSellTime	string	停售时间
language	string	影片语言,如：英语
showVersionType	string	影片类型语言,如：英语 2D
planType	string	影厅类型 2D 3D（可能为空）
downNetPrice	decimal	原价
downSalePrice	decimal	销售价
schedules	Schedule[]	排期数据（对象数组, data节点下的字段）
show_time	string	日期（schedules节点数组元素对象中的字段）

JSON返回示例 :

{
  "data": {
    "showList": [
      {
        "showId": "aa32060acf6b09a20054",
        "hallName": "4号真皮沙发厅",
        "cinemaId": "116060",
        "filmId": "178583",
        "filmCode": "05101292023",
        "filmName": "碟中谍7：致命清算（上）",
        "duration": 164,
        "showTime": "2023-07-19 10:10:00",
        "stopSellTime": "2023-07-19 09:55:00",
        "language": "英文",
        "showVersionType": "英语 2D",
        "planType": "2D",
        "downNetPrice": 23.0,
        "downSalePrice": 21.85
      },
      {
        "showId": "4c0a8f8824047f1c0054",
        "hallName": "4号真皮沙发厅",
        "cinemaId": "116060",
        "filmId": "178583",
        "filmCode": "05101292023",
        "filmName": "碟中谍7：致命清算（上）",
        "duration": 164,
        "showTime": "2023-07-19 13:10:00",
        "stopSellTime": "2023-07-19 12:55:00",
        "language": "英文",
        "showVersionType": "英语 2D",
        "planType": "2D",
        "downNetPrice": 23.0,
        "downSalePrice": 21.85
      }
    ],
    "schedules": [
      {
        "show_time": "2023-07-19"
      },
      {
        "show_time": "2023-07-20"
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/movie/getShowSeats

返回格式： json

请求方法： get/post

请求示例： http://接口域名/movie/getShowSeats?appKey=您申请的APPKEY&showId=aa32060acf6b09a20054

请求参数：

参数名称	类型	必填	说明
showId	string	是	场次 id

返回参数：

参数名称	类型	说明
filmInfo	FilmInfo	影片信息（对象类型，详见【获取影片信息&近期排期】接口响应参数中的filmInfo节点数据类型）
showInfo	ShowInfo	场次信息（对象类型，详见【获取影院某影片的场次列表】接口响应参数中的showList节点数组数据类型）
seatsInfo	SeatsInfo	座位数据（对象类型）
restrictions	int	本场次最多允许售卖的座位数量(seatsInfo节点下的)
seats	Seat[]	座位列表 (对象数组类型，seatsInfo节点下的)
seatId	string	座位 id(seats节点数组元素中的字段,以下未特殊说明的字段都是该节点下的字段)
columnNo	string	纵坐标
rowNo	string	横坐标
seatNo	string	座位名称
status	string	售罄状态: N：可售 LK：已售 W：座位维护
lovestatus	int	是否情侣座 0为非情侣座 1为情侣座左 2为情侣座右
areaId	string	区域id
areaPrices	AreaPrice[]	分区座位价格信息，当此字段有值的时候，代表座位里面支持分区价格 (对象数组类型，seatsInfo节点下的)
areaId	string	区域id(areaPrices节点数组元素中的字段)
netPrice	decimal	原价(areaPrices节点数组元素中的字段)
salePrice	decimal	销售价(areaPrices节点数组元素中的字段)

JSON返回示例 :

{
  "data": {
    "filmInfo": {
      "filmId": "178583",
      "filmCode": "05101292023",
      "name": "碟中谍7：致命清算（上）",
      "pic": "https://gw.alicdn.com/i3/O1CN01pA2ZfY1lGKPFWJi7k_!!6000000004791-0-alipicbeacon.jpg_480x480Q30s150.jpg",
      "grade": "9.5",
      "like": 185128,
      "director": "克里斯托夫·迈考利",
      "leading_role": "汤姆·克鲁斯 海莉·阿特维尔 文·瑞姆斯 西蒙·佩吉 丽贝卡·弗格森 凡妮莎·柯比 亨利·科泽尼",
      "publishDate": "2023-07-14 00:00:00",
      "duration": 164,
      "filmTypes": "动作|惊悚|冒险",
      "movieArea": "美国",
      "language": "英语",
      "intro": "刷新极限的传奇特工系列火线回归，感受今夏最真实震撼的银幕冒险！特工伊森·亨特（汤姆·克鲁斯饰）和他的IMF小组将开启迄今为止最危险的一次任务：追踪一种会危及全人类性命的新型武器，并阻止其落入坏人之手。与此同时，伊森曾对抗过的黑暗势力也正在卷土重来，整个世界的命运岌岌可危。面对神秘而强大的敌人，他不得不面对选择使命还是至爱的终极抉择。"
    },
    "showInfo": {
      "showId": "aa32060acf6b09a20054",
      "hallName": "4号真皮沙发厅",
      "cinemaId": "116060",
      "filmId": "178583",
      "filmCode": "05101292023",
      "filmName": "碟中谍7：致命清算（上）",
      "duration": 164,
      "showTime": "2023-07-19 10:10:00",
      "stopSellTime": "2023-07-19 09:55:00",
      "language": "英文",
      "showVersionType": "英语 2D",
      "planType": "2D",
      "downNetPrice": 23.0,
      "downSalePrice": 21.85
    },
    "seatsInfo": {
      "restrictions": 4,
      "seats": [
        {
          "seatId": "MTE2MDYwQF9AMTc4NTgzQF9AMTY4OTczMjYwMEBfQDU0QF9AMzZAX0AzNDAxMDk2MDA0IzAxIzEwQF9AODhAX0AwQF9AMeaOkjEw5bqnQF9AMzAxMDJAX0Az",
          "columnNo": "5",
          "rowNo": "1",
          "seatNo": "1排10座",
          "status": "N",
          "lovestatus": 0,
          "areaId": "3"
        },
        {
          "seatId": "MTE2MDYwQF9AMTc4NTgzQF9AMTY4OTczMjYwMEBfQDU0QF9AMzZAX0AzNDAxMDk2MDA0IzAxIzA5QF9AODhAX0AwQF9AMeaOkjnluqdAX0AzMDEwMkBfQDM=",
          "columnNo": "6",
          "rowNo": "1",
          "seatNo": "1排9座",
          "status": "N",
          "lovestatus": 0,
          "areaId": "3"
        }
      ],
      "areaPrices": [
        {
          "areaId": "3",
          "netPrice": 23.00,
          "salePrice": 21.85
        },
        {
          "areaId": "1",
          "netPrice": 23.00,
          "salePrice": 21.85
        },
        {
          "areaId": "2",
          "netPrice": 23.00,
          "salePrice": 21.85
        }
      ]
    }
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/movie/createOrder

返回格式： json

请求方法： post

接口说明：

下单流程图.png

请商户严格按照该预订流程对接，不然会存在：无效订单占比过高(即：只下单不支付的单子)，接口账户被系统自动封禁的风险。

下单成功请及时支付,创单成功15分钟未支付的订单将自动取消。所有场次在开场前60分钟后停售，商户要做好下单校验限制。

（http Post 方式提交，json格式传参，http请求头部需设置：Content-Type:application/json）

请求参数：

参数名称	类型	必填	说明
appKey	string	是	接口账号
customerOrderNo	string	是	商户订单号（即你们自己平台的本地订单号，用于双方订单关联映射。单号值必须唯一，否则会被系统判定为重复下单进行拦截）
orderAmount	decimal	是	订单总金额（后台会校验，传错会下单失败）
cinemaId	string	是	影院ID
filmId	string	是	影片ID
showId	string	是	场次ID
seatIds	string[]	是	选择的座位ID集合
acceptChangeSeat	bool	是	当选择的座位已售时，是否接受换座出票
mobile	string	是	订票手机号
callBackUrl	string	否	订单状态变更异步回调地址，回调详见:订单状态推送通知说明

返回参数：

参数名称	类型	说明
orderNo	string	订单号

JSON请求示例 :

{
  "appKey": "您申请的APPKEY",
  "customerOrderNo": "848949823",
  "orderAmount": 72.2 ,
  "cinemaId": "116060",
  "filmId":"176571",
  "showId": "1172646073",
  "mobile": "18912349876" ,
  "acceptChangeSeat": true,
  "seatIds": ["3401096002#08#07","3401096002#08#08"]
}

JSON返回示例 :

{
    "data": {
        "orderNo": "M23072122435365554"
    },
    "success": true,
    "msg": "请求成功"
}

接口地址： http://接口域名/movie/autoPay

返回格式： json

请求方法： post

请求参数：

参数名称	类型	必填	说明
appKey	string	是	接口账号
orderNo	string	是	电影票订单号
payAmount	decimal	是	订单支付金额（可为null ,传值时将和订单金额进行比对；传值时就参与签名，为null时不参与签名）
sign	string	是	签名校验值，md5(secretKey+orderNo+payAmount+secretKey)，secretKey为请求密钥，开通账户时即可获得，加密结果转为32位小写。【注意：加密前的拼接原串不包含'+'】

返回参数：

参数名称	类型	说明
success	bool	true表示代扣支付成功；false表示代扣失败,msg为失败原因。

JSON请求示例 :

{
  "appKey": "您申请的APPKEY",
  "orderNo": "M23072122435365554",
  "payAmount": 72.2,
  "sign":"17fb3f159a93cf6a5d0275565d1a0954"
}

JSON返回示例 :

{
    "data": true,
    "success": true,
    "msg": "请求成功"
}

接口地址： http://接口域名/movie/getOrderDetail

返回格式： json

请求方法： get/post

请求示例： http://接口域名/movie/getOrderDetail?appKey=您申请的APPKEY&orderNo=M23072122435365554

请求参数：

参数名称	类型	必填	说明
appKey	string	是	接口账号
orderNo	string	是	电影票订单号

返回参数：

参数名称	类型	说明
orderNo	string	磐河电影票订单号
customerOrderNo	string	采购商本地订单号
cinemaId	string	影院ID
cinemaName	string	影院名称
cinemaAddress	string	影院地址
cinemaTel	string	影院电话
cityName	string	城市名称
longitude	string	影院经度
latitude	string	影院纬度
filmId	string	影片ID
filmName	string	影片名称
filmImg	string	电影海报图片
showId	string	场次ID
seatIds	string	购买座位的 seatId 集合,多个英文逗号分隔
hallName	string	影厅名称
showTime	string	开场时间
mobile	string	订票手机号
acceptChangeSeat	bool	是否允许换座
ticketNum	int	影票张数
seatNos	string	出票成功后的座位名称，多个座位“,”隔开（如果换座出票的，值跟OriginalSeatNos就会不一样）
originalSeatNos	string	用户下单时选择的座位名称，多个座位“,”隔开
ticketsData	string	影票数据，出票成功才有值。json数组格式：[{"serialNumber":" 取票码(有的平台又叫序列号)","verificationCode":"验证码","qrCodeUrl":"取票二维码"}]
ticketTime	datetime	出票成功时间
orderAmount	decimal	订单总金额
orderStatus	int	电影票订单状态值（新订单待支付 = 1 , 已支付待出票 = 2 , 出票中 = 3,已出票 = 4,出票失败 = 5, 已取消 = 6, 退票中 = 7,已退票 = 8, 退票失败 =9 ）
payStatus	int	支付状态,对应枚举PayStatus值（0未支付 1已支付）
payTime	datetime	支付时间
transactionNo	string	支付交易单号,可用于查账
refundAmount	decimal	出票失败/退票成功时给客户的退款金额
refundSuccessTime	datetime	出票失败/退票成功后，退款成功时间
refundTransactionNo	出票失败/退票成功后，退款成功	出票失败/退票成功后，退款交易单号,可用于查账
callbackUrl	string	订单回调地址（由采购商提交订单时传入的）
payLimitTime	datetime	最晚支付截止时间，超过此值将无法支付，默认值：下单时间createTime + 15分钟
unFinishedReason	string	出票失败原因（当订单状态为退票失败 =9 时，就是退票失败原因）
createTime	datetime	下单时间

JSON返回示例 :

{
  "data": {
    "orderNo": "M23072122435365554",
    "customerOrderNo": "848949823",
    "cinemaId": "116060",
    "cinemaName": "中影嘉莱国际影城（奥园4K巨幕店）",
    "cinemaAddress": "蜀山区长江西路奥园城市天地4楼（1楼南门手扶梯旁电梯间电梯可直达4楼影城）",
    "cinemaTel": "0551-65857007 ",
    "cityName": "合肥",
    "longitude": "117.167609",
    "latitude": "31.852047",
    "filmId": "176571",
    "filmName": "八角笼中",
    "filmImg": "https://gw.alicdn.com/i4/O1CN017mWMkN2AEpV9KBFRX_!!6000000008172-0-alipicbeacon.jpg_480x480Q30s150.jpg",
    "showId": "1172646073",
    "seatIds": "3401096002#08#07,3401096002#08#08",
    "hallName": "2号真皮沙发厅",
    "showTime": "2023-07-22 09:20:00",
    "mobile": "18912349876",
    "acceptChangeSeat": true,
    "ticketNum": 2,
    "seatNos": "8排7列,8排8列",
    "originalSeatNos": "8排7列,8排8列",
    "ticketsData": null,
    "ticketTime": null,
    "orderAmount": 72.20,
    "orderStatus": 1,
    "payStatus": 0,
    "payTime": null,
    "transactionNo": null,
    "refundAmount": 0.00,
    "refundSuccessTime": null,
    "refundTransactionNo": null,
    "callbackUrl": null,
    "payLimitTime": "2023-07-22 00:43:53",
    "unFinishedReason": null,
    "createTime": "2023-07-21 22:43:53"
  },
  "success": true,
  "msg": "请求成功"
}

	内容	详细
	售前咨询:	15021905015
	客服热线:	17306152795
	在线客服QQ:	1437759532
	测试工具:	推荐使用PostMan
	技术支持:	info@panhe.net

在线接口文档中心

电影票

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :