• 隐藏侧边栏
  • 展开分类目录
  • 关注微信公众号
  • 我的GitHub
  • QQ:1753970025
Chen Jiehua

Movies-Server API 

目录

重要更新:此处不再更新,点此查看最新版文档!

数据返回格式

统一返回json数据


//请求成功,正常返回
{
    "c": 0, // 0表示正常
    "d": {
        ……   // 具体数据内容
    }
}

//请求异常
{
    "c": -1001, // 负数表示出错
    "d": null,  // 出错时为空
    "err": {
        "msg": ??????? // 错误信息
    }
}

如果接口没有返回任何内容,则可能是服务器后台问题,请联系后台开发人员沟通处理

错误码说明

“”” 协议、校验错误 “”” ERR_PROTOCOL_ERROR = (-1001, “协议解析错误”) ERR_INTERNAL_ERROR = (-1002, “内部错误”) ERR_DECRYPT_FAIL = (-1003, “解密失败”) ERR_INVALID_USER = (-1004, “非法用户”) ERR_INVALID_TOKEN = (-1005, “非法token”) ERR_NEED_TOKEN = (-1006, “缺少token”) ERR_INVALID_TIMESTAMP = (-1007, “时间戳无效”) ERR_REQUEST_PARAM = (-1008, “请求参数错误”) “”” 用户相关 “”” ERR_INVALID_NAME = (-2001, “用户名已被使用”) ERR_INVALID_PHONE = (-2002, “手机号码错误”) ERR_INVALID_PWD = (-2003, “密码错误”) ERR_NEW_PHONE = (-2004, “该手机号码尚未注册”) ERR_OLD_PHONE = (-2005, “该手机号码已被注册”) ERR_CAPTCHA_FAIL = (-2006, “验证码发送失败”) ERR_CAPTCHA_DIFF = (-2007, “验证码错误”) ERR_GET_RCTOKEN = (-2008, “获取融云token失败”) “”” 约会相关 “”” ERR_DEL_APPOINT = (-3001, “删除约会失败”) ERR_DEL_COMMENT = (-3002, “删除评论失败”) ERR_NULL_TIME = (-3003, “约会时间不能为空”) 注意:如果接口返回 -1005, 则要求用户重新登陆

 接口说明

—————————— 用户相关 —————————— 用户登陆 GET:  /v1/user/login

参数名类型说明
phonestring(11)手机号码
pwdstring用户密码
rtint(10)时间戳
{
"c":0,
"d":{
    "token":"60035ef9e144c8662591914b219a252d0c93854e"
    }
}

用户注册 POST:  /v1/user/register

参数名类型说明
phonestring(11)手机号码
pwdstring用户密码
rtint(10)时间戳
{
"c":0,
"d":{
    "token":"60035ef9e144c8662591914b219a252d0c93854e"
    }
}

忘记密码 POST:  /v1/user/findpwd

参数名类型说明
phonestring(11)手机号码
pwdstring新密码
rtint(10)时间戳
{
"c":0,
"d":{
    "token":"60035ef9e144c8662591914b219a252d0c93854e"
    }
}

修改密码 POST:  /v1/user/changepwd

参数名类型说明
tokenstring(40)用户token
old_pwdstring旧密码
new_pwdstring新密码
rtint(10)时间戳
{
"c":0,
"d":{
    "token":"60035ef9e144c8662591914b219a252d0c93854e"
    }
}

验证码 注意:使用推立方验证码 POST:  /v1/user/captcha 不带code参数:用于请求服务器发送验证码

参数名类型说明
phonestring(11)手机号码
actionstring验证码用途:register,findpwd
rtint(10)时间戳

带code参数:用于验证码校验

参数名类型说明
phonestring(11)手机号码
actionstring验证码用途:register,findpwd
codeint(5)验证码
rtint(10)时间戳
{
"c":0,
}

—————————— 电影相关 —————————— 热门电影 GET:  /v1/movie/hot_movie

参数名类型说明
tokenstring(40)用户token
cidint城市id
rtint(10)时间戳
{
"c":0,
"d":{
      "movies": [
            {
                "mactor2": "卡雅·斯考达里奥",
                "myear": 2014,
                "mname": "移动迷宫",
                "mproperty": "动作/悬疑/科幻/惊悚",
                "mid": 174144,
                "id": 2,
                "mtime": "113 分钟",
                "mdirector": "韦斯·波尔",
                "mactor": "迪伦·奥布莱恩",
                "mcover": "http://img31.mtime.cn/mt/2014/09/23/084442.71365987.jpg",
                "mname_en": "The Maze Runner"
            },
            {
                "mactor2": "阿伦·瑞奇森",
                "myear": 2014,
                "mname": "忍者神龟:变种时代",
                "mproperty": "动作/冒险/喜剧/奇幻/科幻",
                "mid": 130928,
                "id": 1,
                "mtime": "101 分钟",
                "mdirector": "乔纳森·理贝斯曼",
                "mactor": "皮特·普劳泽克",
                "mcover": "http://img31.mtime.cn/mt/2014/10/13/151033.93068123.jpg",
                "mname_en": "Teenage Mutant Ninja Turtles"
            },
            ……
       ]
    }
}

附近影院 GET:  /v1/movie/nearby_theater

参数名类型说明
tokenstring(40)用户token
cidint城市id
didint区县id,可选
rtint(10)时间戳
{
"c":0,
"d":{
       "theaters": [
            {
                "roadline": " 21路; 32路; 54区间线; 59路; 65路; 101路; 113路; 213路; 215路; 223路; 320路;324路;326路; 327路; 328路; 329路; 338路; m372路; m391路; m392路; n6路",
                "latitude": 22.5358,
                "longitude": 114.03,
                "tname": "深圳万众国际影城(NEO店)",
                "address": "深圳市香蜜立交NEO大厦A栋3楼",
                "tid": 4072
            },
            {
                "roadline": "地铁1/4号线到达会展中心站C出口",
                "latitude": 22.5336,
                "longitude": 114.059,
                "tname": "深圳博纳国际影城皇庭店",
                "address": "深圳市福田区福华三路118号皇庭广场B1-3",
                "tid": 4663
            },
            ……
        ]
    }
}

搜索影院 GET:  /v1/movie/search_theater

参数名类型说明
tokenstring(40)用户token
cidint城市id
didint区县id,可选
tnamestring影院名称
rtint(10)时间戳
{
"c":0,
"d":{
       "theaters": [
            {
                "roadline": " 21路; 32路; 54区间线; 59路; 65路; 101路; 113路; 213路; 215路; 223路; 320路;324路;326路; 327路; 328路; 329路; 338路; m372路; m391路; m392路; n6路",
                "latitude": 22.5358,
                "longitude": 114.03,
                "tname": "深圳万众国际影城(NEO店)",
                "address": "深圳市香蜜立交NEO大厦A栋3楼",
                "tid": 4072
            },
            {
                "roadline": "地铁1/4号线到达会展中心站C出口",
                "latitude": 22.5336,
                "longitude": 114.059,
                "tname": "深圳博纳国际影城皇庭店",
                "address": "深圳市福田区福华三路118号皇庭广场B1-3",
                "tid": 4663
            },
            ……
        ]
    }
}

搜索电影 GET:  /v1/movie/search_movie

参数名类型说明
tokenstring(40)用户token
keywordstring电影关键字
rtint(10)时间戳
{
"c":0,
"d":{
     "movies": [
            {
                "mname": "一个人的武林",
                "cover": "http://img31.mtime.cn/mt/2014/10/22/092734.28590665.jpg",
                "mid": 199159,
                "director": "陈德森",
                "year": "2014",
                "mname_en": "Kung Fu Jungle"
            },
            {
                "mname": "一个人的突击队",
                "cover": "http://img31.mtime.cn/mt/805/192805/192805.jpg",
                "mid": 192805,
                "director": "Dilip Ghosh",
                "year": "2013",
                "mname_en": "Commando"
            },
            ……
        ]
    }
}

影片信息 GET:  /v1/movie/movie_info

参数名类型说明
tokenstring(40)用户token
midint电影id
rtint(10)时间戳
{
"c":0,
"d":{
        "info": {
            "mactor2": "阿伦·瑞奇森",
            "myear": 2014,
            "mname": "忍者神龟:变种时代",
            "mproperty": "动作/冒险/喜剧/奇幻/科幻",
            "mid": 130928,
            "mactor": "皮特·普劳泽克",
            "mtime": "101 分钟",
            "mdirector": "乔纳森·理贝斯曼",
            "mname_en": "Teenage Mutant Ninja Turtles",
            "mcover": "http://img31.mtime.cn/mt/2014/10/13/151033.93068123.jpg",
            "id": 1
        }
    }
}

影院信息 GET:  /v1/movie/theater_info

参数名类型说明
tokenstring(40)用户token
tidint影院id
rtint(10)时间戳
{
"c":0,
"d":{
       "info": {
            "roadline": "615、781、M253、653",
            "latitude": 22.7189,
            "longitude": 113.799,
            "tname": "南国艺恒国际影城(深圳沙井店)",
            "address": "深圳宝安区沙井街道西环路同心广场3楼",
            "tid": 2857
        }
    }
}

影片上映地点 GET:  /v1/movie/movie_show

参数名类型说明
tokenstring(40)用户token
midint影片id
cidint城市id
rtint(10)时间戳
{
"c":0,
"d":{
        "show": [
            {
                "tid": 2655,
                "tname": "深圳UA影院",
                "dname": "罗湖区",
                "did": 1436,
                "address": "深圳罗湖区深南东路5016号京基百纳空间(KK MALL)购物中心四楼"
            },
            {
                "tid": 1900,
                "tname": "保利国际影城深圳南山店",
                "dname": "南山区",
                "did": 1437,
                "address": "深圳市南山区文心五路保利文化广场B区3楼"
            },
            ……
        ]
    }
}

影院上映时间表 GET:  /v1/movie/theater_show

参数名类型说明
tokenstring(40)用户token
tidint影院id
showdaystring查询日期,eg:20141104,可选,默认查询当天数据
rtint(10)时间戳
{
"c":0,
"d":{
     "show": {
            "showtimecount": 52,   //该影院当天上映的总场数
            "moviecount": 7,    //该影院当天上映的电影部数
            "address": "深圳罗湖区深南东路5016号京基百纳空间(KK MALL)购物中心四楼",
            "latitude": 22.54139,
            "longitude": 114.1052,
            "roadline": "地铁一号线大剧院站B出口\n地王大厦站:观光巴士1线、观光巴士2线、3路、10路、12路、101路、203路、223路、302路、311路、N5路\n深圳书城站:29路、85路、103路、103B路、104路、113路、K113路、204路、K204路、214路、215路、E8路、N3路、N4路、东部假日专线1、海滨4路\n荔枝公园站:7路、23路、24路、30路、33路、62路、63路、K302路、352路、353路、378路、N10路\n寰宇酒店站:377路\n",
            "valuedate": [   //该影院近期有电影上映的日期
                "20141104",
                "20141105",
                "20141111",
                "20141112",
                "20141114",
                "20141115",
                "20141116"
            ],
            "movies": [
                {
                    "mactor2": "阿伦·瑞奇森",
                    "myear": "2014",
                    "mactor": "皮特·普劳泽克",
                    "mtime": "101 分钟",
                    "mdirector": "乔纳森·理贝斯曼",
                    "mname": "忍者神龟:变种时代",
                    "mname_en": "Teenage Mutant Ninja Turtles",
                    "mproperty": "动作/冒险/喜剧/奇幻/科幻",
                    "mcover": "http://img31.mtime.cn/mt/2014/10/13/151033.93068123.jpg",
                    "mid": 130928,
                    "showtimes": [
                        {
                            "version": "3D",
                            "hallid": 5911,    //影院大厅编号,暂时不使用
                            "showtimeid": 0,    //播放场次编号,暂时不使用
                            "language": "英文版",   //影片语言
                            "hallname": "5号厅",   //影院大厅
                            "price": "70",     //影片价格
                            "etime": "预计11:57散场",    //该场次结束时间
                            "seat": 92,       //座位数
                            "mid": 130928,
                            "stime": "10:15:00"   //该场次开始时间
                        },
                        {
                            "version": "IMAX3D",
                            "hallid": 5907,
                            "showtimeid": 0,
                            "language": "英文版",
                            "hallname": "IMAX厅",
                            "price": "100",
                            "etime": "预计12:52散场",
                            "seat": 335,
                            "mid": 130928,
                            "stime": "11:10:00"
                         },
                         ……
                     ]
                },
                {
                    "mactor2": "摩根·弗里曼",
                    "myear": "2014",
                    "mactor": "斯嘉丽·约翰逊",
                    "mtime": "89 min",
                    "mdirector": "吕克·贝松",
                    "mname": "超体",
                    "mname_en": "Lucy",
                    "mproperty": "动作/科幻/惊悚",
                    "mcover": "http://img31.mtime.cn/mt/2014/10/24/161527.42497160.jpg",
                    "mid": 206198,
                    "showtimes": [……]
                },
                ……
            ]
        }
    }
}

—————————— 约会相关 —————————— 创建约会 GET:  /v1/dating/new

参数名类型说明
tokenstring(40)用户token
titlestr约会标题
descriptionstr约会详细信息,暂定为备注信息
notestr保留参数
cidint用户城市id
didint用户区县id
tidint约会影院id
midint约会电影id
expenseint埋单:0:AA;1:我请;2:你请
start_timeint约会时间,10位时间戳
target_sexint约会对象:0:不限;1:男;2:女
target_numint约会人数
rtint(10)时间戳
{
"c":0   //创建成功
}

约会详情 GET:  /v1/dating/detail

参数名类型说明
tokenstring(40)用户token
aidint约会编号
rtint(10)时间戳
{
"c":0,
"d": {
      "comments": [                       //该约会的评论
           {
                "username": "tom",        //评论者姓名
                "uid": 2,                 //评论者uid
                "sex": 0,                 //评论者性别
                "headimg": null,          //评论者头像
                "content": "楼主啊,我来了",  //评论内容
                "time": 1417026204,         //评论时间
                "aid": 4,                   //所属约会
                "apply": 1,                 //是否报名
                "id": 2                     //评论编号,用于删除评论
            },
            ……
        ],
        "appoints":  {
                "aid": 4,                //约会编号
                "username": null,        //用户名
                "age": 0,                //年龄
                "sex": 0,                //性别
                "title": "空虚啊",        //约会标题
                "description": "只要女的哦",       //备注信息
                "start_time": 1480000000,        //约会时间
                "tname": "深圳万众国际影城(NEO店)",          //影院
                "address": "深圳市香蜜立交NEO大厦A栋3楼",      //地址
                "target_num": 1,                 //约会人数
                "target_sex": 1,                 //约会对象
                "apply": 3,                      //报名人数
                "expense": 1,                    //花费,见:创建约会
                "apply": 3,
                "mname": "忍者神龟:变种时代",
                "mname_en": "Teenage Mutant Ninja Turtles",
                "mdirector": "乔纳森·理贝斯曼",
                "mactor": "皮特·普劳泽克",
                "mactor2": "阿伦·瑞奇森",
                "mtime": "101 分钟",
                "mproperty": "动作/冒险/喜剧/奇幻/科幻",
                "mcover": "http://img31.mtime.cn/mt/2014/10/13/151033.93068123.jpg"
     }
}

约会主页 GET:  /v1/dating/home

参数名类型说明
tokenstring(40)用户token
startint最后一个约会编号,用于加载更多,第一次加载赋0值
rtint(10)时间戳
{
"c":0,
"d":{
      "appoints": [
            {
                "aid": 4,                //约会编号
                "username": null,        //用户名
                "age": 0,                //年龄
                "sex": 0,                //性别
                "title": "空虚啊",        //约会标题
                "description": "只要女的哦",       //备注信息
                "start_time": 1480000000,        //约会时间
                "tname": "深圳万众国际影城(NEO店)",          //影院
                "address": "深圳市香蜜立交NEO大厦A栋3楼",      //地址
                "target_num": 1,                 //约会人数
                "apply": 3,                      //报名人数
                "expense": 1,                    //花费,见:创建约会
                "mname": "忍者神龟:变种时代",
                "mcover": "http://img31.mtime.cn/mt/2014/10/13/151033.93068123.jpg"
            },
            ……
        ]
    }
}

附近的约会 GET:  /v1/dating/nearby

参数名类型说明
tokenstring(40)用户token
startint最后一个约会编号,用于加载更多,第一次加载赋0值
rtint(10)时间戳
{
"c":0,
"d":{
      "appoints": [
            {
                "aid": 4,                //约会编号
                "username": null,        //用户名
                "age": 0,                //年龄
                "sex": 0,                //性别
                "title": "空虚啊",        //约会标题
                "description": "只要女的哦",       //备注信息
                "start_time": 1480000000,        //约会时间
                "tname": "深圳万众国际影城(NEO店)",          //影院
                "address": "深圳市香蜜立交NEO大厦A栋3楼",      //地址
                "target_num": 1,                 //约会人数
                "apply": 3,                      //报名人数
                "expense": 1,                    //花费,见:创建约会
                "mname": "忍者神龟:变种时代",
                "mcover": "http://img31.mtime.cn/mt/2014/10/13/151033.93068123.jpg"
            },
            ……
        ]
    }
}

举报约会 GET:  /v1/dating/nearby

参数名类型说明
tokenstring(40)用户token
aidint约会编号
rtint(10)时间戳
{
"c":0
}

删除约会 GET:  /v1/dating/del

参数名类型说明
tokenstring(40)用户token
aidint约会编号
rtint(10)时间戳
{
"c":0
}

我发起的约会 GET:  /v1/user/appoints rtint(10)时间戳

参数名类型说明
tokenstring(40)用户token
{
"c":0,
"d":{
     "appoints": [
            {
                "aid": 4,                //约会编号
                "username": null,        //用户名
                "age": 0,                //年龄
                "sex": 0,                //性别
                "title": "空虚啊",        //约会标题
                "description": "只要女的哦",       //备注信息
                "start_time": 1480000000,        //约会时间
                "tname": "深圳万众国际影城(NEO店)",          //影院
                "address": "深圳市香蜜立交NEO大厦A栋3楼",      //地址
                "target_num": 1,                 //约会人数
                "apply": 3,                      //报名人数
                "expense": 1,                    //花费,见:创建约会
                "mname": "忍者神龟:变种时代",
                "mcover": "http://img31.mtime.cn/mt/2014/10/13/151033.93068123.jpg"
            },
            ……
        ]
    }
}

参加过的约会 GET:  /v1/user/apply rtint(10)时间戳

参数名类型说明
tokenstring(40)用户token
{
"c":0,
"d":{
    "appoints": [
            {
                "aid": 4,                //约会编号
                "username": null,        //用户名
                "age": 0,                //年龄
                "sex": 0,                //性别
                "title": "空虚啊",        //约会标题
                "description": "只要女的哦",       //备注信息
                "start_time": 1480000000,        //约会时间
                "tname": "深圳万众国际影城(NEO店)",          //影院
                "address": "深圳市香蜜立交NEO大厦A栋3楼",      //地址
                "target_num": 1,                 //约会人数
                "apply": 3,                      //报名人数
                "expense": 1,                    //花费,见:创建约会
                "mname": "忍者神龟:变种时代",
                "mcover": "http://img31.mtime.cn/mt/2014/10/13/151033.93068123.jpg"
            },
            ……
        ]
    }
}

—————————— 评论相关 —————————— 创建约会 GET:  /v1/dating/new

参数名类型说明
tokenstring(40)用户token
aidint约会编号
touidint回复用户,0表示直接评论
applyint是否报名,0:否;1:是
rtint(10)时间戳
{
"c":0   //创建成功
}

删除评论 GET:  /v1/comment/del

参数名类型说明
tokenstring(40)用户token
idint评论编号
rtint(10)时间戳
{
"c":0
}

—————————— 配置相关 —————————— 城市列表 GET:  /v1/config/city

参数名类型说明
tokenstring(40)用户token
rtint(10)时间戳
{
"c":0,
"d":{
    "cities": [
            {
                "cname_py": "bj",
                "cid": 290,
                "cname_en": "Beijing",
                "cname": "北京",
                "cname_full": "China_Beijing",
                "id": 1
            },
            {
                "cname_py": "cq",
                "cid": 291,
                "cname_en": "Chongqing",
                "cname": "重庆",
                "cname_full": "China_Chongqing",
                "id": 2
            },
            ……
        ]
    }
}

区县列表 GET:  /v1/config/district

参数名类型说明
tokenstring(40)用户token
cidint城市id
rtint(10)时间戳
{
"c":0,
"d":{
    "districts": [
            {
                "dname": "宝安区",
                "did": 1433,
                "dname_en": "China_Guangdong_Province_Shenzen_Baoan",
                "id": 55,
                "cid": 366
            },
            {
                "dname": "福田区",
                "did": 1434,
                "dname_en": "China_Guangdong_Province_Shenzen_Futian",
                "id": 56,
                "cid": 366
            },
            ……
        ]
    }
}

 

码字很辛苦,转载请注明来自ChenJiehua《Movies-Server API》

评论