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

参数名	类型	说明
phone	string(11)	手机号码
pwd	string	用户密码
rt	int(10)	时间戳

{
"c":0,
"d":{
    "token":"60035ef9e144c8662591914b219a252d0c93854e"
    }
}

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

参数名	类型	说明
phone	string(11)	手机号码
pwd	string	用户密码
rt	int(10)	时间戳

{
"c":0,
"d":{
    "token":"60035ef9e144c8662591914b219a252d0c93854e"
    }
}

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

参数名	类型	说明
phone	string(11)	手机号码
pwd	string	新密码
rt	int(10)	时间戳

{
"c":0,
"d":{
    "token":"60035ef9e144c8662591914b219a252d0c93854e"
    }
}

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

参数名	类型	说明
token	string(40)	用户token
old_pwd	string	旧密码
new_pwd	string	新密码
rt	int(10)	时间戳

{
"c":0,
"d":{
    "token":"60035ef9e144c8662591914b219a252d0c93854e"
    }
}

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

参数名	类型	说明
phone	string(11)	手机号码
action	string	验证码用途：register，findpwd
rt	int(10)	时间戳

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

参数名	类型	说明
phone	string(11)	手机号码
action	string	验证码用途：register，findpwd
code	int(5)	验证码
rt	int(10)	时间戳

{
"c":0,
}

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

参数名	类型	说明
token	string(40)	用户token
cid	int	城市id
rt	int(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

参数名	类型	说明
token	string(40)	用户token
cid	int	城市id
did	int	区县id，可选
rt	int(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

参数名	类型	说明
token	string(40)	用户token
cid	int	城市id
did	int	区县id，可选
tname	string	影院名称
rt	int(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

参数名	类型	说明
token	string(40)	用户token
keyword	string	电影关键字
rt	int(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

参数名	类型	说明
token	string(40)	用户token
mid	int	电影id
rt	int(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

参数名	类型	说明
token	string(40)	用户token
tid	int	影院id
rt	int(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

参数名	类型	说明
token	string(40)	用户token
mid	int	影片id
cid	int	城市id
rt	int(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

参数名	类型	说明
token	string(40)	用户token
tid	int	影院id
showday	string	查询日期，eg：20141104，可选，默认查询当天数据
rt	int(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

参数名	类型	说明
token	string(40)	用户token
title	str	约会标题
description	str	约会详细信息，暂定为备注信息
note	str	保留参数
cid	int	用户城市id
did	int	用户区县id
tid	int	约会影院id
mid	int	约会电影id
expense	int	埋单：0：AA；1：我请；2：你请
start_time	int	约会时间，10位时间戳
target_sex	int	约会对象：0：不限；1：男；2：女
target_num	int	约会人数
rt	int(10)	时间戳

{
"c":0   //创建成功
}

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

参数名	类型	说明
token	string(40)	用户token
aid	int	约会编号
rt	int(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

参数名	类型	说明
token	string(40)	用户token
start	int	最后一个约会编号，用于加载更多，第一次加载赋0值
rt	int(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

参数名	类型	说明
token	string(40)	用户token
start	int	最后一个约会编号，用于加载更多，第一次加载赋0值
rt	int(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

参数名	类型	说明
token	string(40)	用户token
aid	int	约会编号
rt	int(10)	时间戳

{
"c":0
}

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

参数名	类型	说明
token	string(40)	用户token
aid	int	约会编号
rt	int(10)	时间戳

{
"c":0
}

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

参数名	类型	说明
token	string(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)时间戳

参数名	类型	说明
token	string(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

参数名	类型	说明
token	string(40)	用户token
aid	int	约会编号
touid	int	回复用户，0表示直接评论
apply	int	是否报名，0：否；1：是
rt	int(10)	时间戳

{
"c":0   //创建成功
}

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

参数名	类型	说明
token	string(40)	用户token
id	int	评论编号
rt	int(10)	时间戳

{
"c":0
}

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

参数名	类型	说明
token	string(40)	用户token
rt	int(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

参数名	类型	说明
token	string(40)	用户token
cid	int	城市id
rt	int(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》

2014-10-27 2015-10-01 api, docs, movies

Movies-Server API

数据返回格式

错误码说明

接口说明

评论

近期文章

归档

2025年 10月
一	二	三	四	五	六	日
		1	2	3	4	5
6	7	8	9	10	11	12
13	14	15	16	17	18	19
20	21	22	23	24	25	26
27	28	29	30	31

Movies-Server API

数据返回格式

错误码说明

接口说明

评论

近期文章

归档

标签