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

管理员登录

请求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阅读 205,386评论 6赞 479
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 87,939评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 151,851评论 0赞 341
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,953评论 1赞 278
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,971评论 5赞 369
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,784评论 1赞 283
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,126评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,765评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 43,148评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,744评论 2赞 323
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,858评论 1赞 333
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,479评论 4赞 322
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,080评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,053评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,278评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,245评论 2赞 352
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,590评论 2赞 343

推荐阅读更多精彩内容