发现周边电影票Api
  1. 电影接口
发现周边电影票Api
  • 接口注意事项
  • 接口安全
  • 回调说明
  • 渠道账号
    • 账号信息
      GET
  • 影院及院线接口
    • 获取品牌院线
      POST
    • 获取城市的影院列表
      POST
    • 获取影院详细信息及近期排期的影片
      POST
  • 城市地区接口
    • 全国所有城市
      POST
    • 获取城市包含的行政区县
      POST
  • 电影接口
    • 获取影片排期的影院
      POST
    • 获取影片信息及近期排期
      POST
    • 获取电影详细信息
      POST
    • 获取热门电影&待上映电影
      POST
  • 影票订单接口
    • 订单列表
      POST
    • 提交购票需求生成订单
      POST
    • 检验场次座位是否可售
      POST
    • 查询订单
      POST
  • 影院场次接口
    • 获取影院某影片的场次列表
      POST
    • 获取影片某场次的座位列表
      POST
  1. 电影接口

获取热门电影&待上映电影

POST
/api/movie/list
电影接口
责任人:未设置
获取热门电影&待上映电影

请求参数

Query 参数
appId
string 
渠道ID
必需
nonce
string 
随机字符串
必需
sign
string 
签名
必需
timestamp
string 
时间戳
必需
Body 参数application/json
cityCode
string 
城市编码
可选
keywords
string 
可选
按关键词搜索“唐人街探案3”
page
integer <int32>
页码,从0开始
必需
size
integer <int32>
每页条数
必需
type
integer <int32>
必需
0:热门电影 1:待上映电影
示例
{
    "cityCode": "string",
    "keywords": "string",
    "page": 0,
    "size": 0,
    "type": 0
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/movie/list?appId&nonce&sign&timestamp' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cityCode": "string",
    "keywords": "string",
    "page": 0,
    "size": 0,
    "type": 0
}'

返回响应

🟢200成功
*/*
OK
Body
list
array[object (MovieData) {23}] 
可选
actors
array[object (MovieActorData) {4}] 
演员详细信息
可选
cast
string 
参演演员
可选
casts
array[object (MovieCastData) {4}] 
其他演职人员信息
可选
director
string 
导演
可选
directors
array[object (MovieDirectorData) {3}] 
导演详细信息
可选
duration
integer <int32>
时长(分钟)
可选
filmTypes
string 
影片类型
可选
grade
number <double>
评分
可选
hasVideos
boolean 
预告片
可选
images
array[string]
可选
剧情图片,json数据:字符串数组
intro
string 
影片简介
可选
language
string 
影片语言
可选
like
integer <int32>
想看
可选
movieArea
string 
影片制作地区
可选
movieCode
string 
可选
专资办影片统一编码11位(12位编码去除第四位)
movieId
string 
电影id
可选
name
string 
电影名称
可选
photos
array[object (MoviePhotoData) {4}] 
剧照
可选
pic
string 
影片海报地址
可选
picHd
string 
海报高清地址
可选
publishDate
string <date-time>
上映时间
可选
versionTypes
string 
上映类型
可选
videos
array[object (MovieVideoData) {5}] 
预告片
可选
total
integer <int64>
可选
示例
{
    "list": [
        {
            "actors": [
                {
                    "name": "string",
                    "nameEn": "string",
                    "profile": "string",
                    "roleName": "string"
                }
            ],
            "cast": "string",
            "casts": [
                {
                    "castName": "string",
                    "castNameEn": "string",
                    "name": "string",
                    "nameEn": "string"
                }
            ],
            "director": "string",
            "directors": [
                {
                    "name": "string",
                    "nameEn": "string",
                    "profile": "string"
                }
            ],
            "duration": 0,
            "filmTypes": "string",
            "grade": 0,
            "hasVideos": true,
            "images": [
                "string"
            ],
            "intro": "string",
            "language": "string",
            "like": 0,
            "movieArea": "string",
            "movieCode": "string",
            "movieId": "string",
            "name": "string",
            "photos": [
                {
                    "image": "string",
                    "origin": "string",
                    "subtypeDesc": "string",
                    "typeDesc": "string"
                }
            ],
            "pic": "string",
            "picHd": "string",
            "publishDate": "2019-08-24T14:15:22Z",
            "versionTypes": "string",
            "videos": [
                {
                    "cover": "string",
                    "duration": 0,
                    "title": "string",
                    "typeDesc": "string",
                    "url": "string"
                }
            ]
        }
    ],
    "total": 0
}
🟢201成功
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
上一页
获取电影详细信息
下一页
订单列表
Built with