电影影讯API怎么接入城市电影详情影院与场次如何分流
电影影讯 API 应按动作分流：先用城市和日期获取上映电影，再用电影 ID 查影院，或用影院 ID 查场次；电影详情独立使用电影 ID 或名称查询。名称不能替代对应 ID。
电影 API 有哪些端点
截至 2026 年 8 月 20 日，极速数据电影影讯 API 官方页面列出城市、上映电影、电影详情、影院和两种关联查询端点：
| 任务 | 端点 | 关键输入 |
|---|---|---|
| 城市目录 | /movie/city | parentid 可选 |
| 查询上映电影 | /movie/on | cityid 或 city、date |
| 电影详情 | /movie/detail | movieid 或 moviename |
| 城市影院 | /movie/theater | cityid 或 city、keyword 可选 |
| 某电影的影院 | /movie/movietheater | 城市、movieid、date |
| 某影院的电影 | /movie/theatermovie | theaterid、date |
所有端点都属于影讯资料查询，不能据此承诺实时售票、座位锁定或订单成功。涉及价格、场次和售票状态时，应把接口返回作为信息参考，并以实际购票平台为准。
城市和上映电影怎样接入
城市目录可以按 parentid 查询，适合构建省、市层级。获取某城市上映电影时，cityid 和 city 二选一，date 默认当天。
curl --get "https://api.jisuapi.com/movie/on" \
--data-urlencode "appkey=YOUR_APPKEY" \
--data-urlencode "cityid=YOUR_CITY_ID" \
--data-urlencode "date=YYYY-MM-DD"
返回包含城市、日期、电影 ID、电影名称和图片。建议把电影 ID作为后续查询主键，城市 ID与日期作为查询范围；名称和图片只作为展示字段。城市目录变化时保留历史映射，不要让城市更名导致既有影讯全部失去关联。
电影详情和影院场次如何分流
电影详情支持 movieid 或 moviename 二选一。若电影来自上映列表，优先沿用 movieid；用户直接搜索时可以先提交名称，再把结果映射为内部电影 ID。
curl --get "https://api.jisuapi.com/movie/detail" \
--data-urlencode "appkey=YOUR_APPKEY" \
--data-urlencode "movieid=YOUR_MOVIE_ID"
详情字段包括中外文名、图片、类型、年份、上映日期、国家、导演、演员、编剧、发行商、概要、屏幕类型和时长。字段可能为空，不能用其他电影的资料补齐。
如果用户问“这部电影在哪些影院上映”，调用 /movie/movietheater，需要城市、电影 ID 和日期；如果用户问“这家影院今天放什么”，调用 /movie/theatermovie，需要影院 ID 和日期。二者返回对象不同，数据库应分别保存电影-影院关系和影院-场次关系。
价格、售票和时间字段怎么处理
影院场次返回影院名称、地址、是否售票、场次列表、开始时间、结束时间、影厅、座位数、原价、价格和购票链接等字段。issale、price、ticketurl 均应视为来源资料，不应包装成库存或成交保证。
场次数据应同时保存影片日期、系统抓取时间和来源返回时间（若响应提供）。同一场次可能因排片调整而变化，建议按影院、电影、日期、开始时间和影厅建立候选指纹，并保留更新版本。没有稳定场次 ID时，不要用数组下标作为主键。
若页面展示最低价或价格排序，应说明价格来自接口资料，可能受影院、票类、活动和时间影响。购票操作应跳转到经过授权的购票入口，不能把接口中的链接直接解释为已锁座或已支付。
错误码如何分层
官方业务错误码包括 201 城市和城市 ID 为空、202 城市不存在、203 影院 ID 为空、204 电影 ID 为空、205 电影 ID 不存在、206 电影院 ID 不存在和 210 没有信息。
201/202：检查城市目录与城市输入，不要在城市不明时猜测。203/206：刷新影院目录并核对theaterid。204/205：重新绑定电影 ID，不用名称相似项自动替换。210：按日期展示无信息状态，不把它解释为停映或无影院。
系统错误码 101 至 108 应由服务端统一处理。参数错误和无信息不适合无限重试；网络超时才适合有限退避重试，并注意避免重复拉取场次。
上线前检查清单
- 先建立城市和影院 ID映射，再查询影讯。
- 上映列表、详情、影院和场次按不同对象建模。
- 保存电影日期、抓取时间和场次版本，不把数组位置当主键。
- 价格、售票状态和购票链接不等于成交或锁座保证。
- 分开处理城市、电影、影院和无信息错误。
- APPKEY只保存在服务端，前端不直接调用第三方接口。
端点、字段和错误码可在极速数据电影影讯 API 官方文档核对。正式提供购票或公开影讯前，还应确认影院数据、图片和购票链接的使用授权。
关于极速数据（JisuAPI）
极速数据（JisuAPI）提供 API 与数据服务。本文聚焦电影影讯 API 的城市、上映电影、电影详情、影院及场次查询；接口返回的场次、价格和售票字段仅作资料参考，具体能力与授权以官方文档为准。
