文档
测试

获取影院排期

GET
getShows

接口描述

查询指定影院排期,请勿一直拉取,接口有限制(1分钟60次,上线后会放宽),建议客户访问时实时获取

请求参数

参数名
类型
描述
必填
partnerCode
String
合作商编号 每个合作商唯一
必填
cinemaId
String
影院编号
必填
searchFilmId
String
示例:00100012023
可选
searchDate
String
某个时间下的排期,示例:2023-03-08
可选
searchStartTime
String
影片开场时间, 示例15:20 (若是15: 则表示15点下的所有排期)
可选

响应参数

参数名
类型
描述
必填
duration
Int
示例:129 影片时长
必填
imgUrl
String
影片图片 示例:https://gw.alicdn.com/i2/O1CN01dWNA1C1LWeLTIkd0n_!!6000000001307-0-alipicbeacon.jpg_480x480Q30s150.jpg
必填
score
String
示例:6.9 评分
必填
address
String
示例:西城区马连道路25号新年华购物中心5层 影院地址
必填
cityName
String
示例:北京 城市名称
必填
filmId
String
示例:125244
必填
cinemaName
String
示例:北京耀莱成龙国际影城(马连道店) 影院名字
必填
latitude
String
示例:39.8774310636 影院维度 (百度地图)
必填
longitude
String
示例:116.326389341 影院经度 (百度地图)
必填
filmName
String
示例:中国医生 影片名字
必填
dates
Json数组
数据列表
必填
date
String
示例:2021-07-28 日期
必填
list
Json数组
数据列表
必填
showId
String
排期编号 示例:Nzk3I0BpbWFubUAjMTI1MjQ0I0BpbWFubUAjMTYyNzQ3MTUwMCNAaW1hbm1AIzIjQGltYW5tQCM0OQ==
必填
showPrice
Decimal
示例:34.9 官方价格
必填
salePrice
Decimal
示例:34.9 建议零售价 (只限特惠订单使用)
必填
disableFlag
Int
示例:1 是否有效 0有效,1无效 (只针对特惠购票,快捷看settlementQuickPrice有无值判断)
必填
startTime
String
示例:2021-07-28 19:25:00 开始时间
必填
language
String
示例:国语 语言
必填
endTime
String
示例:2021-07-28 21:34 结束时间
必填
supplierCode
String
示例:
必填
hallName
String
示例:百厅庆百年5号厅(3D眼镜需自备或购买) 影厅名称
必填
version
String
示例:国语 2D
必填
settlementPrice
Decimal
特惠订单供货价
必填
quickPrice/settlementQuickPrice
String
示例:21.85 快捷订单供货价 (quickPrice为兼容的旧字段)
可选
minSettlementPrice
string
最小结算价 (某些影院不同座位有不同价格时会有这个价格)
必填
minShowPrice
string
最小市场价(某些影院不同座位有不同价格时会有这个价格)
必填
minSalePrice
string
最小销售价(某些影院不同座位有不同价格时会有这个价格)
必填
minSettlementQuickPrice
string
最小快捷结算价(某些影院不同座位有不同价格时会有这个价格)
可选
minQuickPrice
string
最小快捷结算价(某些影院不同座位有不同价格时会有这个价格)
可选
areas
array
分区座位,可能为空
可选
areaId
string
分区座位id
可选
showPrice
Decimal
分区座位原价
可选
settlementPrice
Decimal
分区座位供货价
可选
settlementQuickPrice
Decimal
分区座位快捷供货价
可选
filmTypes
String
示例:剧情
必填