POST/plugin.yz-cinema-ticket.api.film.get-cinema

传入参数说明:

参数名 类型 说明
city_id int 城市id 必传
area string 区域名称 例:白云区 非必传
film_id int 电影id 必传
lng string 经度
lat string 纬度
page int 页码
limit int 每页大小
date string 观影日期

返回示例:

正确时返回:

{
    "code": 0,
    "data": {
        "current_page": 1,
        "data": [
            {
                "address": "红荔新村16栋",
                "cinema_name": "诚丰影城从化店",
                "cinema_service": {
                    "3D眼镜自费购买": "5元/副",
                    "WiFi": "影院提供免费WIFI",
                    "儿童优惠": "1.2m以下儿童观看2d普通影片免票无座，每位成人仅限带一名儿童"
                },
                "city_name": "广州",
                "id": 76530,
                "latitude": "23.543599",
                "longitude": "113.595855",
                "max_discount": 2.61,
                "net_price": "2500",
                "net_price_text": 29,
                "phone": "18026228503",
                "region_name": "从化市",
                "schedule": [
                    {
                        "fast_stop_sell_time": 1778301720,
                        "hi": "13:00",
                        "max_discount": 2.61,
                        "net_price": 29,
                        "rapid_time": 1778301720,
                        "settle_price": 26.39,
                        "show_id": "y_d3c941da33ced1df9ded85088cb9561e",
                        "show_type": 0,
                        "start_time": 1778302800,
                        "stopSellStatus": 0,
                        "stop_sale_time": "2026-05-09 12:20:00",
                        "stop_sell_time": 1778300400
                    },
                    {
                        "fast_stop_sell_time": 1778304720,
                        "hi": "13:50",
                        "max_discount": 2.61,
                        "net_price": 29,
                        "rapid_time": 1778304720,
                        "settle_price": 26.39,
                        "show_id": "y_db8f747cbf5e8d412be05dc21a537acb",
                        "show_type": 0,
                        "start_time": 1778305800,
                        "stopSellStatus": 0,
                        "stop_sale_time": "2026-05-09 13:10:00",
                        "stop_sell_time": 1778303400
                    },
                    {
                        "fast_stop_sell_time": 1778311020,
                        "hi": "15:35",
                        "max_discount": 2.61,
                        "net_price": 29,
                        "rapid_time": 1778311020,
                        "settle_price": 26.39,
                        "show_id": "y_0e645e31d48ba8ded1dd3e1963b9ae70",
                        "show_type": 0,
                        "start_time": 1778312100,
                        "stopSellStatus": 0,
                        "stop_sale_time": "2026-05-09 14:55:00",
                        "stop_sell_time": 1778309700
                    },
                    {
                        "fast_stop_sell_time": 1778314020,
                        "hi": "16:25",
                        "max_discount": 2.61,
                        "net_price": 29,
                        "rapid_time": 1778314020,
                        "settle_price": 26.39,
                        "show_id": "y_6e9f10d3677d4332fb8f42c95935e782",
                        "show_type": 0,
                        "start_time": 1778315100,
                        "stopSellStatus": 0,
                        "stop_sale_time": "2026-05-09 15:45:00",
                        "stop_sell_time": 1778312700
                    },
                    {
                        "fast_stop_sell_time": 1778323320,
                        "hi": "19:00",
                        "max_discount": 2.61,
                        "net_price": 29,
                        "rapid_time": 1778323320,
                        "settle_price": 26.39,
                        "show_id": "y_1c21fbd10da29d3bea585e99b0c55fd0",
                        "show_type": 0,
                        "start_time": 1778324400,
                        "stopSellStatus": 0,
                        "stop_sale_time": "2026-05-09 18:20:00",
                        "stop_sell_time": 1778322000
                    },
                    {
                        "fast_stop_sell_time": 1778328420,
                        "hi": "20:25",
                        "max_discount": 2.61,
                        "net_price": 29,
                        "rapid_time": 1778328420,
                        "settle_price": 26.39,
                        "show_id": "y_fb10b3e808f5b89a4e8efd5777c4c7da",
                        "show_type": 0,
                        "start_time": 1778329500,
                        "stopSellStatus": 0,
                        "stop_sale_time": "2026-05-09 19:45:00",
                        "stop_sell_time": 1778327100
                    },
                    {
                        "fast_stop_sell_time": 1778332620,
                        "hi": "21:35",
                        "max_discount": 2.61,
                        "net_price": 29,
                        "rapid_time": 1778332620,
                        "settle_price": 26.39,
                        "show_id": "y_889aadf7ff57f9c584b98262e9686ab7",
                        "show_type": 0,
                        "start_time": 1778333700,
                        "stopSellStatus": 0,
                        "stop_sale_time": "2026-05-09 20:55:00",
                        "stop_sell_time": 1778331300
                    }
                ]
            }
        ],
        "has_more": true,
        "last_page": 15,
        "per_page": 15,
        "total": 213
    },
    "msg": "操作成功"
}

错误时返回:

  {
    "errcode": 500,
    "errmsg": "invalid appid"
  }

返回参数说明:

参数名 类型 说明
cinema_name string 影院名称
address string 影院地址
id string 影院id
latitude string 影院纬度
longitude string 影院经度
distance string 距离
phone string 影院电话
cinema_service array 影院服务
max_discount float 最高可优惠

返回参数schedule说明:

参数名 类型 说明
hi string 开场时间
net_price string 原价
settle_price string 现价