匡佳华 / API-Interfaces · Files

Go to a project
学籍认证.md 10.3 KB

1、学籍认证

学籍认证（?method=app.student.verifyStudent）

公共请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
client_secret string 50 否 5ac68f20cb18efe154be 进入接口提供的参数加密信息
app_version float 10 否 1 APP版本
os_version string 20 否 Android4.4 系统版本+机器型号
client_type string 20 否 iphone/android/ipad 手机型号（不区分大小写）
screen_size string 20 否 800x900 （手机尺寸）

请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
uid String 1-11 否 121345 用户uid
client_type String 1-10 否 web 客户端类型
college_name String 1-100 否 南京大学 学校名称
education_degree String 1-10 否 本科 学历层次
enrollment_year String 1-4 否 2011 入学年份
graduate_year String 1-4 是 2015 毕业年份
education_category String 1 是 1 学籍类型：1：表示普通全日制； 2：表示硕士或者博士研究生； 5：表示成人教育； 6：表示高等教育自学考试； 7：表示网络教育； 8：表示开放教育； 9：表示不详
token String 1-100 是 132165642189798713 身份认证返回url中的token参数

接口说明

接口说明
请求域名 http://api.yoho.cn
接口名 app.student.verifyStudent
学籍认证
http请求方式 POST/GET

返回错误

无 注意，通用的头部没有列出。 请求示例
http://192.168.102.205:8080/gateway?method=app.student.verifyStudent&uid=32&client_type=web&college_name=南京大学&education_degree=本科&enrollment_year=2011&token=132165642189798713

响应

code为200即为成功，否则是失败。 响应参数，data部分
响应成功JSON格式如下所示:

{
    "alg":"SALT_MD5",
    "code":200,
    "data":{
        "isStudent":1,                  // 1-是，0-否
        "serialNo":1234,                // 认证序号
        "prompt":"100有货币已到账"        // 认证提示语
    },
    "md5":"f4a7a490bb6666b005008d795ed14e5d",
    "message":"verify student."
}

2、获取学生认证分享url

获取学生认证分享url（method=app.student.getShareUrl）

公共请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
client_secret string 50 否 5ac68f20cb18efe154be 进入接口提供的参数加密信息
app_version float 10 否 1 APP版本
os_version string 20 否 Android4.4 系统版本+机器型号
client_type string 20 否 iphone/android/ipad 手机型号（不区分大小写）
screen_size string 20 否 800x900 （手机尺寸）

请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
shareUid int 64 否 123587 空白 分享者的uid
shareId int 64 否 87 空白 分享的id

注意，通用的头部没有列出。 请求示例
http://localhost:8080/gateway/?method=app.student.getShareUrl&shareUid=222&shareId=15

响应

code为200即为成功，否则是失败。 响应参数，data部分
响应成功JSON格式如下所示:

{
  "alg": "SALT_MD5",
  "code": 200,
  "data": {
    "content": "2015感恩季！品牌专属优惠券限时送！ 先领券，再购物，让你乐享整个冬季！",
    "pic": "http://img12.static.yhbimg.com/taobaocms/2015/11/28/08/0271d0cd65f4603b1f92dc037510d9b396.jpg?imageView/2/w/640/h/640",
    "title": "Yoho!Buy有货2015感恩季，1000万元+品牌专属优惠券大派送！",
    "url": "http://huodong.m.yohobuy.com/cuxiao/coupon/girlsbrand?uid=222"
  },
  "md5": "29a5abfa7ed26701f92424aab8b8bdda",
  "message": "操作成功"
}

3、查询院校有多少人认证

查询院校有多少人认证 method=app.student.verifiedStudentTotalByCollege）

公共请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
client_secret string 50 否 5ac68f20cb18efe154be 进入接口提供的参数加密信息
app_version float 10 否 1 APP版本
os_version string 20 否 Android4.4 系统版本+机器型号
client_type string 20 否 iphone/android/ipad 手机型号（不区分大小写）
screen_size string 20 否 800x900 （手机尺寸）

请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
college_name String 64 否 安徽大学 空白 大学名称

注意，通用的头部没有列出。 请求示例
http://localhost:8080/gateway/?method=app.student.verifiedStudentTotalByCollege&college_name=安徽大学&debug=XYZ

响应

code为200即为成功，否则是失败。 响应参数，data部分
响应成功JSON格式如下所示:

{
  "alg": "SALT_MD5",
  "code": 200,
  "data": 1,
  "md5": "0a889a487c7a02759c66b9f44e2425c5",
  "message": "verifiedStudentTotalByCollege total."
}

4、根据用户uid查询这个用户是哪个学校认证的

根据用户uid查询这个用户是哪个学校认证的（method=app.student.getCollegeByUid）

公共请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
client_secret string 50 否 5ac68f20cb18efe154be 进入接口提供的参数加密信息
app_version float 10 否 1 APP版本
os_version string 20 否 Android4.4 系统版本+机器型号
client_type string 20 否 iphone/android/ipad 手机型号（不区分大小写）
screen_size string 20 否 800x900 （手机尺寸）

请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
uid int 64 否 123 0

注意，通用的头部没有列出。 请求示例
http://localhost:8080/gateway/?method=app.student.getCollegeByUid&uid=8050800&debug=XYZ

响应

code为200即为成功，否则是失败。 响应参数，data部分
响应成功JSON格式如下所示:

{
  "alg": "SALT_MD5",
  "code": 200,
  "data": {
    "collegeName": "安徽大学",
    "isStudent": 0,
    "serialNo": 0
  },
  "md5": "58b999bb66f6d50a91858fa51f3afab7",
  "message": "getCollegeByUid result."
}

5、添加用户学生分享记录

添加用户学生分享记录=method=app.student.addShare）

公共请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
client_secret string 50 否 5ac68f20cb18efe154be 进入接口提供的参数加密信息
app_version float 10 否 1 APP版本
os_version string 20 否 Android4.4 系统版本+机器型号
client_type string 20 否 iphone/android/ipad 手机型号（不区分大小写）
screen_size string 20 否 800x900 （手机尺寸）

请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
shareUid int 64 否 15755 分享者uid
uid int 否 123423 被分享者uid

注意，通用的头部没有列出。 请求示例
http://192.168.102.205:8080/gateway?method=app.register.validBackpwdCode&area=86&mobile=15051889346&code=1547

响应

code为200即为成功，否则是失败。 响应参数，data部分
响应成功JSON格式如下所示:

{
  "alg": "SALT_MD5",
  "code": 200,
  "data": {
    "code": 200,
    "message": "success"
  },
  "md5": "06bbdc05222da8384e9a214b8bb3a178",
  "message": "操作成功"
}

6、获取用户分享记录

获取用户分享记录 method=app.student.getShareLog）

公共请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
client_secret string 50 否 5ac68f20cb18efe154be 进入接口提供的参数加密信息
app_version float 10 否 1 APP版本
os_version string 20 否 Android4.4 系统版本+机器型号
client_type string 20 否 iphone/android/ipad 手机型号（不区分大小写）
screen_size string 20 否 800x900 （手机尺寸）

请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
shareUid int 64 是 4578 分享者的uid

注意，通用的头部没有列出。 请求示例
http://localhost:8080/gateway/?method=app.student.getShareLog&shareUid=1544

响应

code为200即为成功，否则是失败。 响应参数，data部分
响应成功JSON格式如下所示:

{
  "alg": "SALT_MD5",
  "code": 200,
  "data": [
    {
      "reward": "500",
      "create_time": 1481015383,
      "nickName": "haha1245阿斯蒂芬123dffdf"
    },
    {
      "reward": "500",
      "create_time": 1481097432,
      "nickName": "陈希臻"
    },
    {
      "reward": "500",
      "create_time": 1481100710,
      "nickName": "pet****yliu@gmail.com"
    }
  ],
  "md5": "a55d28d9d4defdf1a3149125b74b77b5",
  "message": "操作成功"
}

7、获取院校数量

获取院校数量 method=app.student.getCollegeTotal）

公共请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
client_secret string 50 否 5ac68f20cb18efe154be 进入接口提供的参数加密信息
app_version float 10 否 1 APP版本
os_version string 20 否 Android4.4 系统版本+机器型号
client_type string 20 否 iphone/android/ipad 手机型号（不区分大小写）
screen_size string 20 否 800x900 （手机尺寸）

请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注

注意，通用的头部没有列出。 请求示例
http://localhost:8080/gateway/?method=app.student.getCollegeTotal&shareUid=1544

响应

code为200即为成功，否则是失败。 响应参数，data部分
响应成功JSON格式如下所示:

{
  "alg": "SALT_MD5",
  "code": 200,
  "data": 3066,
  "md5": "d8fe79fc53a9a2d90055cae46b7b20f6",
  "message": "CollegeTotal total."
}