海滨校园助手api使用文档

公共接口

公共接口面向所有组织及个人开放，开发者可以凭借用户授权秘钥确认用户身份，以及获取用户姓名班级等信息。

1.公共接口调用链接为：

1
https://hbscher.ctftools.com/pubapi?safekey=xxxxx

将其中的xxxxx改成对应的秘钥即可，授权秘钥只能使用一次，用完即失效

2.返回数据样式：

  • 成功
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
    "data":[
        {
            "id":1,						//用户在本平台的唯一身份码
            "uid":16853046,					//用户学号
            "uname":"王启航",					//用户姓名
            "grade":"16",					//用户年级
            "college":"计算机与信息技术学院",			//用户所在学院
            "speciality":"物联网",				//用户所在专业
            "clazz":"物联网1601"					//班级
        }
    ],
    "code":200,
    "msg":"操作成功"
}
  • 失败
1
2
3
4
5
{
    "data":null,
    "code":500,
    "msg":"秘钥错误"
}

专用接口

专用接口仅面向学校可信组织开放，开发者可以凭借学号、姓名、专业、班级这四个信息之一获取与之相关信息。

1.专用接口调用链接为：

1
url?token=专用秘钥&keytype=索引类型&keyword=索引数据

其中url与专用秘钥请联系admin@ctftools.com申请资格，索引类型分为四类，分别是bj(班级)、zy(专业)、uid(学号)、unme(姓名)，索引数据为索引类型对应的数据，例如以下示例：

1
2
3
url?token=xxxx&keytype=bj&keyword=物联网1601

url?token=xxxx&keytype=uid&keyword=16853046

2.返回数据样式：

  • 单个
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
    "data":[
        {
            "id":1,						//用户在本平台的唯一身份码
            "uid":16853046,					//用户学号
            "uname":"王启航",					//用户姓名
            "grade":"16",					//用户年级
            "college":"计算机与信息技术学院",			//用户所在学院
            "speciality":"物联网",				//用户所在专业
            "clazz":"物联网1601"					//班级
        }
    ],
    "code":200,
    "msg":"操作成功"
}
  • 多个
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
    "data":[
        {
            "id":1,						//用户在本平台的唯一身份码
            "uid":16853046,					//用户学号
            "uname":"王启航",					//用户姓名
            "grade":"16",					//用户年级
            "college":"计算机与信息技术学院",			//用户所在学院
            "speciality":"物联网",				//用户所在专业
            "clazz":"物联网1601"					//班级
        },
        {
            "id":1,						//用户在本平台的唯一身份码
            "uid":16853046,					//用户学号
            "uname":"王启航",					//用户姓名
            "grade":"16",					//用户年级
            "college":"计算机与信息技术学院",			//用户所在学院
            "speciality":"物联网",				//用户所在专业
            "clazz":"物联网1601"					//班级
        }
    ],
    "code":200,
    "msg":"操作成功"
}

问题与建议都可以联系：admin@ctftools.com

#编程 #文档
海滨校园助手api使用文档
https://blog.ctftools.com/2018/06/post242/
作者
Dr3@m
发布于
2018年6月4日
许可协议