卖座后台管理系统接口文档

环境 返回顶部

1. 测试环境地址: http://132.232.87.95:3000

接口列表

1. 城市模块
2. 影院模块
3. 区域模块
4. 电影模块
5. 用户模块

城市模块

1. 城市列表接口

   • 接口地址 /city/getListum

   • 请求参数

     
     xxxxxxxxxx
     {
       pageNum: '当前页',
       pageSize: '每页条数'
     }
     

   • 返回数据

   
   xxxxxxxxxx
      {
       "code": "666",
          "msg": "success",
          "pageNum": "当前页",
          "total": '总条数',
          "cities": []
      }
   

2. 城市列表接口(全部城市)

   • 接口地址 /city/allCity

   • 请求参数 无

   • 返回

     
     xxxxxxxxxx
      {
         "code": "666",
         "msg": 'success',
         "cities": []
        }
     

3) 添加城市接口

• 接口地址 /city/add

• 请求参数

  
  xxxxxxxxxx
  {
    name: '',
    pinyin: '',
    isHost: ''
  }
  

• 返回结果

  
  xxxxxxxxxx
  {
    code: '666',
    msg: 'success'
  }
  

4) 编辑城市接口

• 接口地址 /city/edit

• 请求参数

  
  xxxxxxxxxx
  {
    cityId: '',
    name: '',
    pinyin: '',
    isHost: ''
  }
  

• 返回

  
  xxxxxxxxxx
  {
    code: '666',
    msg: 'success'
  }
  

5) 删除城市接口

• 接口地址 /city/delById

• 请求参数 cityId

• 返回

  
  xxxxxxxxxx
  {
      code: '666',
      msg: 'success'
  }
  

地区模块

1. 地区列表接口

   • 接口地址 /area/getList

   • 请求参数

     
     xxxxxxxxxx
     {
       pageNum: '当前页',
       pageSize: '每页条数'
     }
     

• 返回

  
  xxxxxxxxxx
  {
    code:'666',
    msg: 'success',
    areas: []
  }
  

1. 添加地区接口

   • 接口地址 /area/add

   • 请求参数

     
     xxxxxxxxxx
     {
       cityId: '',
       cityName: '',
       name: '地区名称'
     }
     

   • 返回

     
     xxxxxxxxxx
     {
         code: '666',
         msg: 'success'
     }
     

8) 修改地区接口

• 接口地址 /area/edit

• 请求参数

  
  xxxxxxxxxx
  {
    areaId: '地区id',
    cityId: '',
    cityName: '',
    name: '地区名称'
  }
  

• 返回

  
  xxxxxxxxxx
  {
      code: '666',
      msg: 'success'
  }
  

1. 删除地区接口

   • 接口地址 /area/delById

   • 请求参数 areaId

   • 返回

     
     xxxxxxxxxx
     {
         code: '666',
         msg: 'success'
     }
     

2. 城市 id 查找地区

• 接口地址 /area/findByCityId

• 请求参数 cityId

• 返回

  
  xxxxxxxxxx
  {
      code: '666',
      msg: 'success'
  }
  

影院模块

1. 添加(编辑)影院

   1. 请求地址 /cinema/add(edit)

   2. 请求参数

      
      xxxxxxxxxx
      {
        cinemaId: '编辑时需要',
        cityId: '',
        cityName: '',
        areaId: '',
        areaName: '',
        name: '影院名称',
        address: '地址',
        lowPrice: '最低价格',
      }
      

   
   xxxxxxxxxx
   ​
   

2. 请求类型 post

3. 返回

   
   xxxxxxxxxx
   {
     code: '666',
   msg: 'success'
   }
   

电影模块

1. 电影列表

   • 接口地址: /film/getList

   • 请求参数

     
     xxxxxxxxxx
     {
       pageSize: '每页条数',
       pageNum: '当前页数'
     }
     

• 返回

  
  xxxxxxxxxx
  {
    code: '666',
    msg: 'success',
    films: []
  }
  

1. 添加

   • 接口地址: /film/add

   • 请求参数

     
     xxxxxxxxxx
     {
         "category": "科幻",
         "director": "郭帆",
         "premiereAt": "1549324800",
         "name": "流浪地球",  // 必须
         "photos": [
           'xxx.png',
           'xxx.png'
         ],
         "actors": [{
                 "name": "郭帆",
                 "role": " 导演",
                 "avatarAddress": "头像图片地址"
              },
              {
                 "name": "屈楚萧",
                 "role": "刘启  ",
                 "avatarAddress": "头像图片地址"
              },
         ],
         "poster": "海报图片地址",
         "grade": "8",
         "language": "汉语普通话   英语",
         "runtime": "100",
         "filmType": "2D",
         "isPresale": "true",
         "timeType": "3",
         "isSale": "true",
         "synopsis": "介绍",
         "nation": "中国大陆 "
     }
     ​
     

2. 编辑接口

   • 接口地址: '/film/edit'

   • 请求参数

     
     xxxxxxxxxx
     {
       filmId: ''
       ...添加接口的请求参数
     }
     

   • 返回

     
     xxxxxxxxxx
     {
       code: '666',
       msg: '添加成功'
     }
     

用户模块

1. 获取验证码接口

   • 接口地址: /user/getSmsCode

   • 请求参数

     
     xxxxxxxxxx
     {
       phone: '手机号码'
     }
     

   • 返回

     
     xxxxxxxxxx
     {
       code: '666',
       msg: '验证码成功发送'
     }
     

2. 登录接口

   • 接口地址: /user/loginBySmsCode

   • 请求参数

     
     x
     {
       phone: '手机号码',
       smsCode: '验证码'
     }
     

   • 返回

     
     xxxxxxxxxx
     {
       code: '666',
       msg: '登录成功'
     }