目 录CONTENT

文章目录

猫眼电影API

Administrator
2020-07-24 / 0 评论 / 0 点赞 / 11509 阅读 / 17861 字

猫眼电影API接口文档

文档说明

  • 运行平台:nodejs

  • 服务器语言:NodeJS+mysql

  • 服务器地址:www.softeem.xin

  • 编写人员:杨标

  • 编写时间:2019年9月10日星期二

一、获取城市列表

  1. 描述

    该功能主要是用于获取所有城市的列表

  2. 请求地址

    操作名称/maoyanApi/dianying/cities.json
    协议https
    请求方式GET
    URL全径请参考第5点
  3. 请求参数

  4. 返回数据

    返回的数据是一个json对象,里面字段如下

    序号名称类型备注
    1ctsArray城市列表数组
    2IdNumber序号
    3nmString城市中文名称
    4pyString城市英文名称
  5. 请求URL实例

    https://www.softeem.xin/maoyanApi/dianying/cities.json

  6. 返回数据实例

    实例数据
    Json数据实例{"cts": [{"id": 1,"nm": "北京","py": "beijing"}......]}

二、获取即将上映电影信息

  1. 描述

    调用此接口可获取某一个城市某一个时间段内即将上映的电影信息

  2. 请求地址

    操作名称/maoyanApi/ajax/comingList
    协议https
    请求方式GET
    URL全径请参考第5点
  3. 请求参数

    序号参数名中文名称必选数据类型长度备注
    1ci城市编码YNumber 需市编码,通过上一个接口获取的城市编码
    2token随机效果码YString 此参数请留空
    3limit获取多少条YNumber 获取多少条记录
  4. 返回数据

    返回的数据是一个json对象

    序号名称类型备注
    1comingArray即将上映的电影
    2movieIdsArray所有电影的ID

    电影详细信息,movieList里面单个对象

    序号名称类型备注
    1globalReleasedBoolean是否全球上映
    2haspromotionTagBoolean是否有推荐标志(是否是推荐电影)
    3idNumber电影的编号
    4imgString电影图片的URL地址,请将图片地址中的”w.h”更改为”128.180”,“128.180”是图片的大小
    5nmString电影名称
    6preShowBoolean是否是预告片
    7rtString上映时间
    8scString电影评分
    9showInfoString电影的上映信息
    10showstNumber无实际意义,用户请忽略
    11starString电影演员明星
    12versionString电影版本
    13wishNumber多少人想看
    14wishstNumber无实际意义,用户请忽略
    15comingTitleString电影上映日期
  5. 请求URL实例

    https://www.softeem.xin/maoyanApi/ajax/comingList?ci=57&token=&limit=10

  6. 返回数据实例

    数据实例
    Json数据实例{"coming": [{"id": 1227611,"haspromotionTag": false,"img": "http://p0.meituan.net/w.h/movie/d18915868f6e3e6e287162354700690f2338229.jpg","version": "","nm": "小小的愿望","preShow": false,"sc": 0,"globalReleased": false,"wish": 233489,"star": "彭昱畅,王大陆,魏大勋","rt": "2019-09-12","showInfo": "2019-09-12 本周四上映","showst": 4,"wishst": 0,"comingTitle": "9月12日 周四"},.......],movieIds:[]}

三、获取正在热映电影信息

  1. 描述

    调用此接口获取猫眼电影正在热映的电影信息

  2. 请求地址

    操作名称/maoyanApi/ajax/movieOnInfoList
    协议https
    请求方式GET
    URL全径请参考第5点
  3. 请求参数

  4. 返回数据

    返回的数据是一个json对象

    序号名称类型备注
    1comingArray即将上映的电影,此项为空
    2movieIdsArray所有电影的ID
    3movieListArray所有电影信息的列表
    4stidString当前请求的随机状态码,请用户忽略
    5stidsArray所有电影的随机状态码,请用户忽略
    6totalNumber一共有多少电影信息

    电影详细信息,movieList里面单个对象

    序号名称类型备注
    1globalReleasedBoolean是否全球上映
    2haspromotionTagBoolean是否有推荐标志(是否是推荐电影)
    3idNumber电影的编号
    4imgString电影图片的URL地址,请将图片地址中的”w.h”更改为”128.180”,“128.180”是图片的大小
    5nmString电影名称
    6preShowBoolean是否是预告片
    7rtString上映时间
    8scString电影评分
    9showInfoString电影的上映信息
    10showstNumber无实际意义,用户请忽略
    11starString电影演员明星
    12versionString电影版本
    13wishNumber多少人想看
    14wishstNumber无实际意义,用户请忽略
  5. 请求URL实例

    https://www.softeem.xin/maoyanApi/ajax/movieOnInfoList

  6. 返回数据实例

    数据实例
    Json数据实例{"coming": [],"movieIds": [],"stid": "576591972453269000","stids": [],"total": 62,"movieList": [{"id": 359377,"haspromotionTag": false,"img": "http://p0.meituan.net/w.h/movie/2918a5e403dde6e4254941968d7719ce3942369.jpg","version": "","nm": "罗小黑战记","preShow": false,"sc": 9.4,"globalReleased": true,"wish": 167173,"star": "刘明月","rt": "2019-09-07","showInfo": "今天127家影院放映1685场","showst": 3,"wishst": 0}....]}

四、获取城市电影院信息

  1. 描述

    调用此接口获取某一城市电影院信息

  2. 请求地址

    操作名称/maoyanApi/ajax/cinemaList
    协议https
    请求方式GET
    URL全径请参考第5点
  3. 请求参数

    序号参数名中文名称必选数据类型长度备注
    1day当前日期YString 请求的日期如2019-9-10
    2cityId当前城市的编号YNumber 某一城市ID,传入此ID后可获取当前城市的电影院 信息
    3updateShowDay更新显示日期YBoolean 填写默认值true
    4limit获取记录条数YNumber 默认请填写20
  4. 返回数据

    返回的数据是一个json对象

    序号名称类型备注
    1cinemasArray当前请求城市的电影院列表
    2ct_poisArray当前电影院的地址ID
    3pagingObject分页的对象信息

    电影院详细信息,cinemas里面单个对象

    序号名称类型备注
    1addrString当前电影院的地址
    2distanceString电影院距离
    3idNumber电影院院编号
    4markBoolean是否有标记(收藏)
    5nmString电影院名称
    6promotionObject电影院促销信息
    7sellPriceString电影票价
    8tagObject当前电影标标签
    tag属性allowRefundNumber是否允许退款
    buyoutNumber无实际意义,用户请忽略
    cityCardTagNumber城市卡标记
    vipTagNumberVIP是否有折扣卡
    snackNumber是否有小吃
    endorseNumber是否可以改签
    hallTypeVOListObject其它信息

    分页信息里面的paging里面的对象信息

    序号名称类型备注
    1hasMoreBoolean是否还有更多数据
    2limitNumber当前要取多少条
    3offsetNumber当前跳过了多少条
    4totalNumber当前一共有多少条数据
  5. 请求URL实例

    https://www.softeem.xin/maoyanApi/ajax/cinemaList?day=2019-9-11&cityId=57&updateShowDay=true&limit=20

  6. 返回数据实例

    Json数据实例"cinemas": [{"id": 6092,"mark": 0,"nm": "汉南影城","sellPrice": "23","addr": "汉南区汉南大道315号武商量贩五楼","distance": "887.5km","tag": {"allowRefund": 1,"buyout": 0,"cityCardTag": 0,"deal": 0,"endorse": 1,"hallTypeVOList": [],"sell": 1,"snack": 1,"vipTag": "折扣卡"},"promotion": {}},ct_pois:[{"ct_poi": "936879945111165696_a6092_c0","poiid": 2499576},......],"paging": {"hasMore": true,"limit": 20,"offset": 0,"total": 140}}

五、获取获取票房信息

  1. 描述

    获取猫眼电影的票房信息

  2. 请求地址

    操作名称/maoyanApi/box/promovie/api/box/second.json
    协议https
    请求方式GET
    URL全径请参考第5点
  3. 请求参数

  4. 返回数据

    返回的数据是一个json对象

    序号名称类型备注
    1successBoolean是否请求成功,成功为true
    2dataObject请求
    crystalObject电影当日上映信息
    listArray电影票房信息列表
    queryDateString查询日期
    serverTimeString服务器时间
    serverTimestampNumber服务器时间戳
    splitTotalBoxString分账总票房
    splitTotalBoxInfoString分账总票房信息
    splitTotalBoxUnitString单位
    splitTotalBoxUnitInfoString单位
    totalBoxString总票房
    totalBoxInfoString总票房信息
    totalBoxUnitString单位
    totalBoxUnitInfoString单位
    updateInfoString票房更新时间

    单个票房信息数据展示

    序号名称类型备注
    1avgSeatViewString平均上座率
    2avgShowViewString均场人次
    3avgViewBoxString忽略
    4boxInfoString实时票房
    5boxRateString票房占比
    6movieIdString电影编号
    7movieNameString电影名称
    8releaseInfoString上映信息
    9seatRateString电影上座率
    10showRateString排版占比
  5. 请求URL实例

https://www.softeem.xin/maoyanApi/box/promovie/api/box/second.json

  1. 返回数据实例

    Json数据实例数据量过大,请直接请求数据以作参考

六、获取电影详细信息

  1. 描述

    获取猫眼中某一个电影的详细信息

  2. 请求地址

    操作名称/maoyanApi/ajax/detailmovie
    协议https
    请求方式GET
    URL全径请参考第5点
  3. 请求参数

    序号参数名中文名称必选数据类型长度备注
    1movieId电影IDYString 电影的编号
  4. 返回数据

    返回的数据是一个json对象,快递的主要信息在detailMovie里面

    序号名称类型备注
    1detailMovieBoolean是否请求成功,成功为true
    detailMovie中的属性albumImgString海报图片
    availableEpisodesNumber可用的插曲
    awardUrlStringURL地址
    backgroundColorString背景颜色
    bingeWatchNumber一次看完人数
    bingeWatchstNumber无实际意义
    catString电影分类
    draString电影简介信息
    durNumber持续时间,分钟为单位
    enmString电影的外文名称
    episodeDurString电影一集时长
    episodesNumber电影有几段
    globalReleasedBoolean电影是否有全球上映
    idNumber电影编号
    imgString电影图片URL,请将”w.h”换成具体图片大小如128.180
    musicNameString电影音乐名称
    musicNumNumber音乐数量
    musicStarNumber唱歌的演员
    nmString电影名称
    onSaleBoolean是否正在售票
    onlinePlayBoolean是否可在线播放
    oriLangString电影语言
    photosArray电影图片集(海报集)
    pubDescString电影上映信息
    rtString电影上映时间
    scString电影评分
    starString电影明星演员
    verString电影版本,如2D/4DX
    videourlString电影预告片URL
    videoNameString电影预告片名称
    videoImgString电影预告片图片
    wishNumber多少人想看
    watchedNumber多少人已经观看
  5. 请求URL实例

    https://www.softeem.xin/maoyanApi/ajax/detailmovie?movieId=359377

  6. 返回数据实例

    Json数据实例数据量过大,请直接请求数据以作参考
0

评论区