后台管理系统接口需求分析


管理员登录

请求URL:

  • ./public/RootLogin

请求方式:

  • POST

参数:

参数名 必选 类型 说明
username string 管理员用户名
password string 密码

返回示例

  {
    "code": "OK",
    "data": {
        "token": "73186b2324b65e1280d81c0f8a6465275a9cda063dfd67.57329289",
        "user_info": {
            "username": "xnliu",
        }
    }
}

用户管理


获取用户列表(只获取上传过user_name的用户)

请求URL:

  • ./UserController/userList

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string 管理员token
user_name string user_name用于查询
page int 页码数,默认为1
page_size int pagesize

获取用户:condition['user_name']='xnliu'

返回示例

{
    "code": "OK",
    "data": {
        "user_list": [
            {
                "open_id": "olx8H0UHfk3RrzTe4ofZBWzl8J-0",
                "nick_name": "小黄人",
                "user_name": "欧阳清",
                "avatar_url": "https://wx.qlogo.cn/mmopen/vi_32/wUMSLGCic1FOhTM5yV1Nw3S7txib7v0Fp0TPogtegNUeqvKS9t0OFxRiaqo27KgxtwReJmicUkeHl3FX2fxVVuZwmA/0",
                "gender": 2,
                "city": "Hangzhou",
                "province": "Zhejiang",
                "country": "China",
                "language": "zh_CN",
                "status": "NORMAL",
                "mobile": "135********",
                "email": "12345678@163.com",
                "university": "浙江大学",
                "subject": "机械设计",
                "degree": "研究生",
                "payment": "0.01"
            },
            {
                "open_id": "olx8H0UHfk3RrzTe4ofZBWzl8J-0",
                "nick_name": "花开",
                "user_name": "朱梓骁",
                "avatar_url": "https://wx.qlogo.cn/mmopen/vi_32/wUMSLGCic1FOhTM5yV1Nw3S7txib7v0Fp0TPogtegNUeqvKS9t0OFxRiaqo27KgxtwReJmicUkeHl3FX2fxVVuZwmA/0",
                "gender": 2,
                "city": "Hangzhou",
                "province": "Zhejiang",
                "country": "China",
                "language": "zh_CN",
                "status": "NORMAL",
                "mobile": "135********",
                "email": "1234567@163.com",
                "university": "清华大学",
                "subject": "化学工业",
                "degree": "本科",
                "payment": "0.01"
            }
        ]
    }
}

返回参数说明

参数名 类型 说明
payment float 用户累计消费
status string STOP NORMAL分别表示被停用和正常

获取用户简单列表,用于查询时显示

请求URL:

  • ./UserController/getAAUserList

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string 管理员token
user_name string user_name用于查询
page int 页码数,默认为1
page_size int pagesize

获取用户:condition['user_name']='xnliu'

返回示例

{
    "code": "OK",
    "data": {
        "user_list": [
            {
                "open_id": "olx8H0UHfk3RrzTe4ofZBWzl8J-0",
                "nick_name": "小黄人",
                "user_name": "欧阳清",
                "status": "NORMAL",
            },
            {
                "open_id": "olx8H0UHfk3RrzTe4ofZBWzl8J-0",
                "nick_name": "花开",
                "user_name": "朱梓骁",            
                "status": "NORMAL",            
            }
        ]
    }
}

获取用户数量

请求URL:

  • ./UserController/userNum

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string 管理员token
user_name string user_name用于查询
page int 页码数,默认为1

获取用户:condition['user_name']='xnliu'

返回示例

{
    "code": "OK",
    "data": {       
     total_num: 5
    }
}

高校管理


高校列表接口

请求URL:

  • ./UniversityController/universityList

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string shopAdmin token
page int 页码数,默认为1
page_size int 每页条目数,默认为20

返回示例

 {
    "code": "OK",
    "data": {
    "list": [
             {
                "university_id": 1,
                "university_name": "Harvard",
                "badge": "jss292424.png",
                "photo": "bsdihdjaass.png",
                "rank": 1,
                "status": "NORMAL",
                "desc": "Philadelphia University is located in Philadelphia, Pennsylvania, USA. In 1884, the Philadelphia Philology School",
                "address": "Philadelphia, Pennsylvania, USA"
            },
            {
                "university_id": 2,
                "university_name": "William and Mary College",
                "badge": "jss26524.png",
                "photo": "bsdihd455ss.png",
                "rank": 2,
                "status": "NORMAL",
                "desc": "Founded in 1693, the William and Mary College, also known as the William and Mary College, is the second oldest institution of higher education in the nation with a history just behind Harvard University founded in 1636",
                "address": "Virginia, United States"
            },
        ]
     }
}

单个高校信息

请求URL:

  • ./UniversityController/displayUniversity

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string shopAdmin token
university_id int

返回示例

 {
    "code": "OK",
    "data": {
    "universityItem": {
                "university_id": 1,
                "university_name": "Harvard",
                "badge": "jss292424.png",
                "photo": "bsdihdjaass.png",
                "rank": 1,
                "status": "NORMAL",
                "desc": "Philadelphia University is located in Philadelphia, Pennsylvania, USA. In 1884, the Philadelphia Philology School",
                "address": "Philadelphia, Pennsylvania, USA"
            }
     }
}

新增高校信息

请求URL:

  • ./UniversityController/addUniversity

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string Admin token
university_name string 名称,不能为空 ,限制128字符
desc string 描述,不能超过2048字符
rank int 学校排名
address string 高校地址,不能超过128字符
university_attr array 高校校徽图片、介绍图

**TIPS:图片上传接口:./ImageController/uploadImage
input name="file" type视情况指定
返回示例

  "code": "OK",
    "data": {
        "image": {
            "image_id": "8",
            "image_save_name": "b725bb1708a0c5c7a34d0c4d96583629.png",
            "image_hash": "b725bb1708a0c5c7a34d0c4d96583629",
            "upload_path": "PRODUCT_DETAIL"
        }
    }

返回示例

  {
    "code": "OK",
    "data": {
        "university_id": "3"
    }
}

编辑高校信息

请求URL:

  • ./UniversityController/editUniversity

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string Admin token
university_id int 待编辑的university_id
edit_data[university_name] string 名称,不能为空 ,限制128字符
edit_data[desc] string 描述,不能超过2048字符
edit_data[rank] int 学校排名
edit_data[ address] string 高校地址,不能超过128字符
edit_data[university_attr] array 高校校徽图片、介绍图

返回示例

 {
    "code": "OK",
    "data": {
        "msg": "高校信息已成功编辑"
    }
}

删除高校

请求URL:

  • ./UniversityController/deleteUniversity

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string Admin token
university_id int 待删除的university_id

返回示例

  {
    "code": "OK",
    "data": {
        "msg": ""
    }
}

获取高校数量

请求URL:

  • ./UniversityController/universityNum

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string 管理员token
page int 页码数,默认为1

返回示例

{
    "code": "OK",
    "data": {       
     total_num: 5
    }
}

订单管理


订单列表接口

请求URL:

  • ./SalesController/listOrder

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string shopAdmin token
condition array 搜索条件,[‘user_name’=>’xx’,……]
page int 页码数,默认为1
page_size int 每页条目数,默认为20

返回示例

 {
    "code": "OK",
    "data": {
            "order_list": [
             { 
                "order_id": 1,
                "order_sn": "18021250445844",
                "open_id": "olx8H0Tx0rlev97sa2bCIOQcWVKo",
                "status": "INIT",
                "payment": "200.00",
                "order_time": "2018-02-05 10:31:42",
                "pay_time": null,
                "publication": 200,
                "citation": 200,
                "review": 100,
                "immigration_type": "EB1A",
                 "user_info":{
                      "open_id": "olx8H0UHfk3RrzTe4ofZBWzl8J-0",
                      "nick_name": "花开",
                      "user_name": "朱梓骁",
                      "avatar_url": "https://wx.qlogo.cn/mmopen/vi_32/wUMSLGCic1FOhTM5yV1Nw3S7txib7v0Fp0TPogtegNUeqvKS9t0OFxRiaqo27KgxtwReJmicUkeHl3FX2fxVVuZwmA/0",
                      "gender": 2,
                      "city": "Hangzhou",
                      "province": "Zhejiang",
                      "country": "China",
                      "language": "zh_CN",
                      "status": "NORMAL",
                      "mobile": "135********",
                      "email": "12345678@163.com",
                      "university": "浙江大学",
                      "subject": "化工",
                      "degree": "本科",
                       }        
                },
              {  
                "order_id": 2,
                "order_sn": "18021250445844",
                "open_id": "olx8H0Tx0rlev97sa2bCIOQcWVKo",
                "status": "INIT",
                "payment": "200.00",
                "order_time": "2018-02-05 10:31:42",
                "pay_time": null,
                "publication": 200,
                "citation": 200,
                "review": 100,
                "immigration_type": "EB1A",
                 "user_info":{
                      "open_id": "olx8H0UHfk3RrzTe4ofZBWzl8J-0",
                      "nick_name": "花开",
                      "user_name": "朱梓骁",
                      "avatar_url": "https://wx.qlogo.cn/mmopen/vi_32/wUMSLGCic1FOhTM5yV1Nw3S7txib7v0Fp0TPogtegNUeqvKS9t0OFxRiaqo27KgxtwReJmicUkeHl3FX2fxVVuZwmA/0",
                      "gender": 2,
                      "city": "Hangzhou",
                      "province": "Zhejiang",
                      "country": "China",
                      "language": "zh_CN",
                      "status": "NORMAL",
                      "mobile": "135********",
                      "email": "12345678@163.com",
                      "university": "浙江大学",
                      "subject": "化学工业",
                      "degree": "本科",
            }        
         }
      ]      
    }
}

发起订单服务

请求URL:

  • ./SalesController/serveOrder

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string shopAdmin token
order_id int 订单order_id

返回示例

{
    "code": "OK",
    "data": ""
    }

删除已完成订单

请求URL:

  • ./SalesController/deleteOrder

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string shopAdmin token
order_id int 订单order_id

返回示例

{
    "code": "OK",
    "data": ""
    }

获取订单数量

请求URL:

  • ./SalesController/orderNum

请求方式:

  • POST

参数:

参数名 必选 类型 说明
token string 管理员token
page int 页码数,默认为1

返回示例

{
    "code": "OK",
    "data": {       
     total_num: 5
    }
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,230评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,261评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,089评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,542评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,542评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,544评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,922评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,578评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,816评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,576评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,658评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,359评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,937评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,920评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,156评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,859评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,381评论 2 342

推荐阅读更多精彩内容