良票开放平台 v2.0
  1. 业务侧-影票代订-api
良票开放平台 v2.0
  • 业务端
    • 第三方业务服务商-对接必读
    • 业务侧-影票代订-api
      • 获取城市列表
        POST
      • 获取区县列表
        POST
      • 获取院线列表
        POST
      • 获取在映影片列表
        POST
      • 获取影片详情
        POST
      • 获取影院列表
        POST
      • 获取影院详情
        POST
      • 获取影院场次信息
        POST
      • 获取座位信息(已弃用)
        POST
      • 获取座位信息V2
        POST
      • 创建订单
        POST
      • 支付提交订单
        POST
    • 影票-询价提单场景api
      • 获取预估/一口价-出票价格
      • 创建订单(联动使用)
  1. 业务侧-影票代订-api

获取影院列表

POST
/api/film/cinema/cinemaList
最后修改时间:2025-03-26 02:53:03

请求参数

Query 参数
appId
string 
必需
sign
string 
必需
timestamp
string 
必需
Body 参数application/json
filmId
integer 
电影id
可选
可从获取在映影片列表api出参获得
areaId
string 
地区id
必需
可从获取区县列表api出参获得
cinemaName
string 
影院名称
可选
支持模糊
cinemaLng
string 
经度
可选
cinemaLat
string 
纬度
可选
currentPage
string 
当前页
必需
pageSize
string 
分页大小
必需
showDate
string 
场次日期
已废弃
cinemaLineId
string 
院线id
可选
可从获取院线列表api出参获得
autoSupport
boolean 
是否支持极速出票(秒级)
可选
非必填,当传递该值并且值为true时,仅返回支持自动出票的影院。不传或传值不为true时,返回全部影院
示例
{
    "currentPage": "1",
    "pageSize": "10",
    "areaId": "120116",
    "filmId": 1166400785217699847,
    "cinemaName": "完美世界影城(天津迎宾店)",
    "cinemaLng": "117.45397",
    "cinemaLat": "38.84455",
    "autoSupport":true
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/film/cinema/cinemaList?appId=&sign=&timestamp=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "currentPage": "1",
    "pageSize": "10",
    "areaId": "120116",
    "filmId": 1166400785217699847,
    "cinemaName": "完美世界影城(天津迎宾店)",
    "cinemaLng": "117.45397",
    "cinemaLat": "38.84455",
    "autoSupport":true
}'

返回响应

🟢200成功
application/json
Body
state
integer 
必需
message
string 
必需
data
object 
必需
totalCount
string 
必需
list
array [object {14}] 
必需
hasNext
boolean 
必需
hasPre
boolean 
必需
pageCount
integer 
必需
currentPage
integer 
必需
pageSize
integer 
必需
result
boolean 
必需
token
null 
必需
示例
{
    "state": 200,
    "message": "",
    "data": {
        "totalCount": "19",
        "list": [
            {
                "id": "1166369730292903936",
                "cinemaCode": "12094101",
                "cinemaName": "完美世界影城(天津迎宾店)",
                "province": "天津市",
                "city": "天津市",
                "area": "滨海新区",
                "areaCode": 120116,
                "cinemaAddress": "滨海新区大港世纪大道118号迎宾超市3楼北侧",
                "cinemaLocation": [
                    117.45397,
                    38.84455
                ],
                "cinemaLineId": 0,
                "autoIssueId": 0,
                "streetName": "世纪大道",
                "createTime": "1698125838264",
                "updateTime": "1698125838264"
            },
            {
                "id": "1166369729370157056",
                "cinemaCode": "12090881",
                "cinemaName": "金逸影城天津大港IMAX店",
                "province": "天津市",
                "city": "天津市",
                "area": "滨海新区",
                "areaCode": 120116,
                "cinemaAddress": "大港区世纪大道东易品商业广场A区5F(大港一中对面)",
                "cinemaLocation": [
                    117.488983,
                    38.846554
                ],
                "cinemaLineId": 0,
                "autoIssueId": 0,
                "streetName": "世纪大道",
                "createTime": "1698125838264",
                "updateTime": "1698125838264"
            },
            {
                "id": "1166369729814753280",
                "cinemaCode": "12091191",
                "cinemaName": "新影联长天影城(大港店·特惠包场)",
                "province": "天津市",
                "city": "天津市",
                "area": "滨海新区",
                "areaCode": 120116,
                "cinemaAddress": "滨海新区港东六道与海景七路交口和兴万乐汇3层中部(和兴万乐汇1层和兴集团门口东临客厅上3层即到)",
                "cinemaLocation": [
                    117.49714,
                    38.85757
                ],
                "cinemaLineId": 0,
                "autoIssueId": 0,
                "streetName": "",
                "createTime": "1698125838264",
                "updateTime": "1698125838264"
            },
            {
                "id": "1166369728963309568",
                "cinemaCode": "12092501",
                "cinemaName": "大港油田数字影院",
                "province": "天津市",
                "city": "天津市",
                "area": "滨海新区",
                "areaCode": 120116,
                "cinemaAddress": "天津市滨海新区团结路天津工程职业技术学院(北校区)北侧约70米",
                "cinemaLocation": [
                    117.497498,
                    38.72459
                ],
                "cinemaLineId": 0,
                "autoIssueId": 0,
                "streetName": "团结路",
                "createTime": "1698125838264",
                "updateTime": "1698125838264"
            },
            {
                "id": "1166369731018518528",
                "cinemaCode": "12071061",
                "cinemaName": "万达影城(滨海DOLBY影院)",
                "province": "天津市",
                "city": "天津市",
                "area": "滨海新区",
                "areaCode": 120116,
                "cinemaAddress": "滨海新区自贸试验区(中心商务区)洞庭湖4572号滨海万达广场四层",
                "cinemaLocation": [
                    117.655617,
                    38.994751
                ],
                "cinemaLineId": 0,
                "autoIssueId": 0,
                "streetName": "",
                "createTime": "1698125838264",
                "updateTime": "1698125838264"
            },
            {
                "id": "1166369734663368704",
                "cinemaCode": "12070831",
                "cinemaName": "中影保烽影城(远洋未来汇店)",
                "province": "天津市",
                "city": "天津市",
                "area": "滨海新区",
                "areaCode": 120116,
                "cinemaAddress": "滨海新区天津市滨海新区塘沽远洋中心路89号远洋未来汇四层F401",
                "cinemaLocation": [
                    117.597145,
                    39.036201
                ],
                "cinemaLineId": 0,
                "autoIssueId": 0,
                "streetName": "塘沽远洋中心路",
                "createTime": "1698125838264",
                "updateTime": "1698125838264"
            },
            {
                "id": "1166371622481850368",
                "cinemaCode": "33074921",
                "cinemaName": "至潮影城(万洋广场店)",
                "province": "天津市",
                "city": "天津市",
                "area": "滨海新区",
                "areaCode": 120116,
                "cinemaAddress": "平阳县滨海新区海泽路万洋广场2号楼三层",
                "cinemaLocation": [
                    117.703049,
                    38.957317
                ],
                "cinemaLineId": 0,
                "autoIssueId": 0,
                "streetName": "海泽路",
                "createTime": "1698126267075",
                "updateTime": "1698126267075"
            },
            {
                "id": "1166369738794758144",
                "cinemaCode": "12070791",
                "cinemaName": "万达影城(天津生态城万达广场店)",
                "province": "天津市",
                "city": "天津市",
                "area": "滨海新区",
                "areaCode": 120116,
                "cinemaAddress": "滨海新区中新生态城中天大道与和意路交汇处万达广场三层4F-A号",
                "cinemaLocation": [
                    117.680725,
                    39.016296
                ],
                "cinemaLineId": 0,
                "autoIssueId": 0,
                "streetName": "",
                "createTime": "1698125838264",
                "updateTime": "1698125838264"
            },
            {
                "id": "1166369731807047680",
                "cinemaCode": "12070761",
                "cinemaName": "保利万和国际影城(滨海文化中心店)",
                "province": "天津市",
                "city": "天津市",
                "area": "滨海新区",
                "areaCode": 120116,
                "cinemaAddress": "滨海新区滨海万达对面滨海新区文化中心市民活动中心四至七层",
                "cinemaLocation": [
                    117.685722,
                    39.015751
                ],
                "cinemaLineId": 0,
                "autoIssueId": 0,
                "streetName": "",
                "createTime": "1698125838264",
                "updateTime": "1698125838264"
            },
            {
                "id": "1166371616651767808",
                "cinemaCode": "33071021",
                "cinemaName": "汇星影城(滨海立体公园店)",
                "province": "天津市",
                "city": "天津市",
                "area": "滨海新区",
                "areaCode": 120116,
                "cinemaAddress": "龙湾区滨海新区滨海六路置信立体公园4楼汇星影城",
                "cinemaLocation": [
                    117.71071,
                    39.0032
                ],
                "cinemaLineId": 0,
                "autoIssueId": 0,
                "streetName": "滨海6路",
                "createTime": "1698126267075",
                "updateTime": "1698126267075"
            }
        ],
        "hasNext": true,
        "hasPre": false,
        "pageCount": 2,
        "currentPage": 1,
        "pageSize": 10
    },
    "result": true,
    "token": null
}
修改于 2025-03-26 02:53:03
上一页
获取影片详情
下一页
获取影院详情
Built with