小程序端接口需求分析

微信用户登录

请求URL：

  • ./public/wxAppUserCodeComes

请求方式：

  • POST

参数：

参数名 必选 类型 说明
code 是 string wx.login

返回示例

  {
  "code":"OK",
  "data":{
    "token": 'IamTokenFromWxAPPAPI',
    "user_info": {
      "wx_app_open_id": "IamOpenId",
      "wx_app_session_key": "12154545"
    }
    }
  }

返回参数说明

参数名 类型 说明
wx_app_open_id string open_id
wx_app_session_key string session_key

备注

  • 公众号尚未被用户授权时，user_info中nick_name，province等信息暂无，前端调用wx.getUserInfo获取raw_data,session_key用于encryptedData解密；
  • 系统目前open_id和系统账号只是绑定关联，没有绝对依赖，可以暂不考虑wx.checkSession；

微信用户更新微信用户信息接口（用户授权后）

请求URL：

  • ./public/updateWxUserInfo

请求方式：

  • POST

参数：

参数名 必选 类型 说明
token 是 string Get from wx.login response
nick_name 是 string getUserInfo解密后的nick_name
avatar_url 是 string ...avatar_url
gender 是 string ...gender
city 是 string ...city
province 是 string ...province
country 是 string ...country
language 是 string ...language

返回示例

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

返回参数说明

参数名 类型 说明
done string true or false 更新成功或失败

高校推荐模块

获取高校信息列表

请求URL：

  • ./public/HomeController/universityList

请求方式：

  • POST

参数：

返回示例

{
    "code": "OK",
    "data": {
        "list": [
            {
                "university_id": 1,
                "university_name": "Harvard",
                "badge": "jss292424.png",
                "image": "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",
                "image": "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：

  • ./public/HomeController/universityItem

请求方式：

  • POST

参数：

参数名 必选 类型 说明
university_id 是 int

返回示例

{
    "code": "OK",
    "data": {
        "universityItem":  {
                "university_id": 1,
                "university_name": "Harvard",
                "badge": "jss292424.png",
                "image": "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：

  • ./public/HomeController/search

请求方式：

  • POST

参数：

参数名 必选 类型 说明
token 是 string Get from wx.login response
keywords 是 string 默认为空字符串
page 否 int 默认为1

返回示例

{
    "code": "OK",
    "data": {
        "list": [
            {
                "university_id": 1,
                "university_name": "Harvard",
                "badge": "jss292424.png",
                "image": "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：

  • ./public/UserController/getUserInfo

请求方式：

  • POST
    参数：
参数名 必选 类型 说明
token 是 string

返回示例

{
    "code": "OK",
    "data": {
        "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：

  • ./public/updateWxUserInfo

请求方式：

  • POST
    参数：
参数名 必选 类型 说明
token 是 string Get from wx.login response
user_name 是 string
mobile 是 string
email 是 string
university 是 string
province 是 string
subject 是 string
degree 是 string

返回示例

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

创建订单

请求URL：

  • ./OrderController/placeOrder

请求方式：

  • POST
    参数：
参数名 必选 类型 说明
token 是 string Get from wx.login response
publication 是 string
citation 是 string
review 是 string
immigration_type 是 string
payment 是 string

返回示例

 {
    "code": "OK",
    "data": {
        "order_info": {
            "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：

  • ./OrderController/recordOrder

请求方式：

  • POST
    参数：
参数名 必选 类型 说明
token 是 string Get from wx.login response
order_id 是 int
order_sn 是 string
status 是 string

返回示例

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

status为订单状态，分为INIT(待付款)，PAID(已付款)，SERVED（已服务）,CANCELLED(已取消)。
注：只要订单的状态为已付款则系统将把订单信息发送至管理员邮箱

个人中心模块

获取订单列表

请求URL：

  • ./OrderController/getOrderList

请求方式：

  • POST
    参数：
参数名 必选 类型 说明
token 是 string Get from wx.login response
status 是 string

返回示例

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

推荐阅读更多精彩内容