42 KiB
42 KiB
业务流程梳理
- 用户输入账号密码进行客户端登录，系统校验用户是否存在系统和密码是否正确，输入信息正确后判断用户类型；
- 当用户类型登录的为教育用户时（区县一级），返回的schools接口（其实获取的是区域的检测计划，映射到日常体测中即为获取区县教育用户设置的日常检测计划，对应的表为sys_daily_plan）
- 在此用户登录的基础上，projectId即为sys_daily_plan中的id
- 在后续的接口中的schoolID字段设置为sys_daily_plan中的companyId进行传参；
- 后续返回的school数据结构中按照sys_company中的信息进行返回；
- 再往后的接口中
PhysicalProjects中返回sys_daily_plan_school中对应daily_id中的所有学校信息，可以理解为选择对应的检测学校； - 基于上一步，后续的projectId全部传递sys_daily_plan_school中的id作为对应的项目ID
- 当用户登录的类型为学校用户时，查询对应的sys_daily_plan_school表中的schoolId
- 后续的操作中参照教育用户登录选择的内容返回sys_daily_plan中的名称，第二部直接就选择该学校即可；
同步服务器时间
https://ty.hxhh.tech/hhcrm/api/HHDevices/getcurrenttime
{"value":"2025-09-16 10:13:56","result":0,"message":""}
登录接口
url: "https://ty.hxhh.tech/hhcrm/api/tokens"
type: 'post'
requestbody:
{
"clientid": "6D587F96",
"mac": "Mac地址：db:b2:5d:a7:a4:5e",
"password": "ou7eMPFsoMrbfMA05cnIiQ\u003d\u003d\n",
"systemflag": 2,
"userId": "18167973603"
}
responseBody:
{
"value": {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjoiMWM0YjFkNDYtYzhhNy00ZGMzLWI5YWMtMGY3ODQxZTFjM2VmIiwiU3lzdGVtRmxhZyI6IjIiLCJDbGllbnRJRCI6IjZENTg3Rjk2IiwibmJmIjoxNzU3OTEyNjE5LCJleHAiOjE3NTc5MzA2MTksImlzcyI6Imh0dHBzOi8vd3d3Lmh1YXhpYWh1aWhhaS5jb20iLCJhdWQiOiJodHRwOi8vd3d3Lmd6aHhoaHR5LmNvbSJ9.ZwNqcje-fuiOGrVqJadiU6-0lxEdUJ08OfFE7wsswQ0",
"expireTime": 18000,
"sign": ""
},
"result": 0,
"message": ""
}
获取学校接口
url: "https://ty.hxhh.tech/hhcrm/api/schools"
type: "get"
header: {
Authorization： "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjoiMWM0YjFkNDYtYzhhNy00ZGMzLWI5YWMtMGY3ODQxZTFjM2VmIiwiU3lzdGVtRmxhZyI6IjIiLCJDbGllbnRJRCI6IjZENTg3Rjk2IiwibmJmIjoxNzU3OTEyNjE5LCJleHAiOjE3NTc5MzA2MTksImlzcyI6Imh0dHBzOi8vd3d3Lmh1YXhpYWh1aWhhaS5jb20iLCJhdWQiOiJodHRwOi8vd3d3Lmd6aHhoaHR5LmNvbSJ9.ZwNqcje-fuiOGrVqJadiU6-0lxEdUJ08OfFE7wsswQ0"
}
{
"result": 0,
"message": "",
"queryObjects": [
{
"id": "1000000607",
"name": "乌鲁木齐学生体测服务平台",
"projectClass": 2,//
"minGrade": 11,
"maxGrade": 44,
"createTime": "2025-09-03T14:32:24.087",
"operater": "姚康",
"maxStudentCount": 420000,
"city": null,
"divisionID": "650100",
"divisionPath": "新疆维吾尔自治区/乌鲁木齐市",
"templateID": null,
"url": "https://ty.hxhh.tech/hhtc/api",
"thirdSyncPlateForm": null,
"modules": 14,//
"projectID": null,
"currentYear": 0,
"isEnableWX": false,
"isUpdateHistroryData": true,
"isStop": 0
}
],
"pageSize": 0,
"pageIndex": 1,
"totalCount": 1
}
获取登录
url: "https://ty.hxhh.tech/hhcrm/api/login",
type: "post",
header: {
Authorization: "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjoiMWM0YjFkNDYtYzhhNy00ZGMzLWI5YWMtMGY3ODQxZTFjM2VmIiwiU3lzdGVtRmxhZyI6IjIiLCJDbGllbnRJRCI6IjZENTg3Rjk2IiwibmJmIjoxNzU3OTEyNjE5LCJleHAiOjE3NTc5MzA2MTksImlzcyI6Imh0dHBzOi8vd3d3Lmh1YXhpYWh1aWhhaS5jb20iLCJhdWQiOiJodHRwOi8vd3d3Lmd6aHhoaHR5LmNvbSJ9.ZwNqcje-fuiOGrVqJadiU6-0lxEdUJ08OfFE7wsswQ0"
}
body: {
"Client": "8寸屏平板体测[V1.0.0_xj01]",
"LocalIP": "192.168.2.56",
"MAC": "7C943ABA6131",
"SchoolID": "1000000607",
"Veryfied": true
}
{
"value": {
"id": "1c4b1d46-c8a7-4dc3-b9ac-0f7841e1c3ef_1000000607",
"userID": "1c4b1d46-c8a7-4dc3-b9ac-0f7841e1c3ef",
"user": {
"id": "1c4b1d46-c8a7-4dc3-b9ac-0f7841e1c3ef",
"userType": 0,
"mobile": "18167973603",
"name": "姜",
"password": null,
"states": 0,
"createTime": "2025-09-03T14:32:54.703",
"email": "",
"operater": null,
"note": "{\"2\":\"\",\"1\":\"\",\"4\":\"\",\"3\":\"新疆阳光学生体质健康管理有限公司\"}",
"hasMobile": true
},
"schoolID": "1000000607",
"school": {
"id": "1000000607",
"name": "乌鲁木齐学生体测服务平台",
"projectClass": 2,
"minGrade": 11,
"maxGrade": 44,
"createTime": "2025-09-03T14:32:24.087",
"operater": "姚康",
"maxStudentCount": 420000,
"city": null,
"divisionID": "650100",
"divisionPath": null,
"templateID": null,
"url": "https://ty.hxhh.tech/hhtc/api",
"thirdSyncPlateForm": null,
"modules": 14,//
"projectID": "TC001097",//
"currentYear": 2025,
"isEnableWX": false,
"isUpdateHistroryData": true,
"isStop": 0
},
"role": "系统管理员",
"expireDate": "2025-12-31T00:00:00",
"permissions": "all",
"selectionType": null,
"selectionItems": null,
"projects": null,
"ukey": false,
"needConfirm": false,
"isAdministrator": true
},
"result": 0,
"message": ""
}
获取检测计划
url: "https://ty.hxhh.tech/hhcrm/api/PhysicalProjects?q=eyJzY2hvb2xJRCI6IjEwMDAwMDA2MDciLCJzb3J0TW9kZSI6Mn0%3D%0A",
type: "get",
header: {
Authorization： "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjoiMWM0YjFkNDYtYzhhNy00ZGMzLWI5YWMtMGY3ODQxZTFjM2VmIiwiU3lzdGVtRmxhZyI6IjIiLCJDbGllbnRJRCI6IjZENTg3Rjk2IiwibmJmIjoxNzU3OTEyNjE5LCJleHAiOjE3NTc5MzA2MTksImlzcyI6Imh0dHBzOi8vd3d3Lmh1YXhpYWh1aWhhaS5jb20iLCJhdWQiOiJodHRwOi8vd3d3Lmd6aHhoaHR5LmNvbSJ9.ZwNqcje-fuiOGrVqJadiU6-0lxEdUJ08OfFE7wsswQ0"
}
{
"result": 0,
"message": "",
"queryObjects": [
{
"id": "SL001600",
"projectClass": 8,
"name": "2025-2026年度上学期学生视力",
"year": 2025,
"createDate": "2025-09-03T16:57:08.35",
"startDate": "2025-09-01T00:00:00",
"endDate": "2026-02-01T23:59:59",
"templateProjectID": "gbsl2021",
"isTemplate": false,
"schoolID": "1000000607",
"school": null,
"state": 0,
"selectionType": null,
"selectionItems": null,
"testItems": null,
"gradeTestItems": null,
"eyeSightTetstItems": null,
"copyingProjectID": null
},
{
"id": "TC001097",
"projectClass": 2,
"name": "2025-2026年度学生体测",
"year": 2025,
"createDate": "2025-09-03T16:57:08.327",
"startDate": "2025-09-01T00:00:00",
"endDate": "2026-09-01T00:00:00",
"templateProjectID": "gbtc2014",
"isTemplate": false,
"schoolID": "1000000607",
"school": null,
"state": 0,
"selectionType": null,
"selectionItems": null,
"testItems": null,
"gradeTestItems": null,
"eyeSightTetstItems": null,
"copyingProjectID": null
}
],
"pageSize": 0,
"pageIndex": 0,
"totalCount": 2
}
获取检测项目
url: "https://ty.hxhh.tech/hhcrm/api/PhysicalProjects/TC001097",
type: "get",
header: {
Authorization: "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjoiMWM0YjFkNDYtYzhhNy00ZGMzLWI5YWMtMGY3ODQxZTFjM2VmIiwiU3lzdGVtRmxhZyI6IjIiLCJDbGllbnRJRCI6IjZENTg3Rjk2IiwibmJmIjoxNzU3OTEyNjE5LCJleHAiOjE3NTc5MzA2MTksImlzcyI6Imh0dHBzOi8vd3d3Lmh1YXhpYWh1aWhhaS5jb20iLCJhdWQiOiJodHRwOi8vd3d3Lmd6aHhoaHR5LmNvbSJ9.ZwNqcje-fuiOGrVqJadiU6-0lxEdUJ08OfFE7wsswQ0"
}
{
"result": 0,
"message": "",
"queryObject": {
"id": "TC001097",
"projectClass": 2,
"name": "2025-2026年度学生体测",
"year": 2025,
"createDate": "2025-09-03T16:57:08.327",
"startDate": "2025-09-01T00:00:00",
"endDate": "2026-09-01T00:00:00",
"templateProjectID": "gbtc2014",
"isTemplate": false,
"schoolID": "1000000607",
"school": {
"id": "1000000607",
"name": "乌鲁木齐学生体测服务平台",
"projectClass": 2,
"minGrade": 11,
"maxGrade": 44,
"createTime": "2025-09-03T14:32:24.087",
"operater": "姚康",
"maxStudentCount": 420000,
"city": null,
"divisionID": "650100",
"divisionPath": null,
"templateID": null,
"url": "https://ty.hxhh.tech/hhtc/api",
"thirdSyncPlateForm": null,
"modules": 14,
"projectID": "TC001097",
"currentYear": 2025,
"isEnableWX": false,
"isUpdateHistroryData": true,
"isStop": 0
},
"state": 0,
"selectionType": null,
"selectionItems": null,
"testItems": [
{
"id": 1,
"name": "身高",
"unit": "厘米",
"pointCount": 1,
"hasMachine": true,
"max": 250.0,
"min": 80.1,
"sortMode": 0,
"formula": null,
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 0,
"isMust": false,
"sex": 0
},
{
"id": 2,
"name": "体重",
"unit": "公斤",
"pointCount": 1,
"hasMachine": true,
"max": 200.0,
"min": 10.1,
"sortMode": 0,
"formula": null,
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 0,
"isMust": false,
"sex": 0
},
{
"id": 24,
"name": "BMI指数",
"unit": "",
"pointCount": 1,
"hasMachine": true,
"max": null,
"min": null,
"sortMode": 0,
"formula": "([体重] * 10000)/([身高] * [身高])",
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 1,
"isMust": false,
"sex": 0
},
{
"id": 4,
"name": "肺活量",
"unit": "毫升",
"pointCount": 0,
"hasMachine": true,
"max": 9999.0,
"min": 500.0,
"sortMode": 2,
"formula": null,
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 0,
"isMust": false,
"sex": 0
},
{
"id": 7,
"name": "坐位体前屈",
"unit": "厘米",
"pointCount": 1,
"hasMachine": true,
"max": 40.0000,
"min": -30.0000,
"sortMode": 2,
"formula": null,
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 0,
"isMust": false,
"sex": 0
},
{
"id": 5,
"name": "50米跑",
"unit": "秒",
"pointCount": 1,
"hasMachine": true,
"max": 19.9,
"min": 5.1,
"sortMode": 1,
"formula": null,
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 2,
"isMust": false,
"sex": 0
},
{
"id": 6,
"name": "立定跳远",
"unit": "厘米",
"pointCount": 0,
"hasMachine": true,
"max": 400.0,
"min": 51.0,
"sortMode": 2,
"formula": null,
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 0,
"isMust": false,
"sex": 0
},
{
"id": 12,
"name": "一分钟仰卧起坐",
"unit": "次",
"pointCount": 0,
"hasMachine": true,
"max": 99.0,
"min": 0.0,
"sortMode": 2,
"formula": null,
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 0,
"isMust": false,
"sex": 0
},
{
"id": 18,
"name": "一分钟跳绳",
"unit": "次",
"pointCount": 0,
"hasMachine": true,
"max": 300.0,
"min": 0.0,
"sortMode": 2,
"formula": null,
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 0,
"isMust": false,
"sex": 0
},
{
"id": 14,
"name": "引体向上",
"unit": "次",
"pointCount": 0,
"hasMachine": true,
"max": 99.0000,
"min": 0.0000,
"sortMode": 2,
"formula": null,
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 0,
"isMust": false,
"sex": 0
},
{
"id": 9,
"name": "50米×8往返跑",
"unit": "分\u0027秒\"",
"pointCount": 0,
"hasMachine": true,
"max": 540.0,
"min": 45.0,
"sortMode": 1,
"formula": null,
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 2,
"isMust": false,
"sex": 0
},
{
"id": 10,
"name": "800米跑",
"unit": "分\u0027秒\"",
"pointCount": 0,
"hasMachine": true,
"max": 540.0,
"min": 120.0,
"sortMode": 1,
"formula": null,
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 2,
"isMust": false,
"sex": 0
},
{
"id": 11,
"name": "1000米跑",
"unit": "分\u0027秒\"",
"pointCount": 0,
"hasMachine": true,
"max": 540.0,
"min": 120.0,
"sortMode": 1,
"formula": null,
"memo": null,
"shortName": null,
"testCount": null,
"precisionMode": 2,
"isMust": false,
"sex": 0
}
],
"gradeTestItems": {
"11_Male": [
1,
2,
4,
5,
7,
18,
24
],
"12_Male": [
1,
2,
4,
5,
7,
18,
24
],
"13_Male": [
1,
2,
4,
5,
7,
12,
18,
24
],
"14_Male": [
1,
2,
4,
5,
7,
12,
18,
24
],
"15_Male": [
1,
2,
4,
5,
7,
9,
12,
18,
24
],
"16_Male": [
1,
2,
4,
5,
7,
9,
12,
18,
24
],
"21_Male": [
1,
2,
4,
5,
6,
7,
11,
14,
24
],
"22_Male": [
1,
2,
4,
5,
6,
7,
11,
14,
24
],
"23_Male": [
1,
2,
4,
5,
6,
7,
11,
14,
24
],
"31_Male": [
1,
2,
4,
5,
6,
7,
11,
14,
24
],
"32_Male": [
1,
2,
4,
5,
6,
7,
11,
14,
24
],
"33_Male": [
1,
2,
4,
5,
6,
7,
11,
14,
24
],
"41_Male": [
1,
2,
4,
5,
6,
7,
11,
14,
24
],
"42_Male": [
1,
2,
4,
5,
6,
7,
11,
14,
24
],
"43_Male": [
1,
2,
4,
5,
6,
7,
11,
14,
24
],
"44_Male": [
1,
2,
4,
5,
6,
7,
11,
14,
24
],
"11_Female": [
1,
2,
4,
5,
7,
18,
24
],
"12_Female": [
1,
2,
4,
5,
7,
18,
24
],
"13_Female": [
1,
2,
4,
5,
7,
12,
18,
24
],
"14_Female": [
1,
2,
4,
5,
7,
12,
18,
24
],
"15_Female": [
1,
2,
4,
5,
7,
9,
12,
18,
24
],
"16_Female": [
1,
2,
4,
5,
7,
9,
12,
18,
24
],
"21_Female": [
1,
2,
4,
5,
6,
7,
10,
12,
24
],
"22_Female": [
1,
2,
4,
5,
6,
7,
10,
12,
24
],
"23_Female": [
1,
2,
4,
5,
6,
7,
10,
12,
24
],
"31_Female": [
1,
2,
4,
5,
6,
7,
10,
12,
24
],
"32_Female": [
1,
2,
4,
5,
6,
7,
10,
12,
24
],
"33_Female": [
1,
2,
4,
5,
6,
7,
10,
12,
24
],
"41_Female": [
1,
2,
4,
5,
6,
7,
10,
12,
24
],
"42_Female": [
1,
2,
4,
5,
6,
7,
10,
12,
24
],
"43_Female": [
1,
2,
4,
5,
6,
7,
10,
12,
24
],
"44_Female": [
1,
2,
4,
5,
6,
7,
10,
12,
24
]
},
"eyeSightTetstItems": null,
"copyingProjectID": null
}
}
权限校验
url: "https://ty.hxhh.tech/hhtc/api/UserPermissions?q=eyJtb2R1bGUiOjIsInByb2plY3RJRCI6IlRDMDAxMDk3Iiwic2Nob29sSUQiOiIxMDAwMDAwNjA3%0AIiwidXNlcklEIjoiMWM0YjFkNDYtYzhhNy00ZGMzLWI5YWMtMGY3ODQxZTFjM2VmIn0%3D%0A",
type: "get"
{
"result": 0,
"message": null,
"queryObjects": [
{
"id": "3cc3c23f-3369-43a4-a937-7e69397f2aec",
"userID": "1c4b1d46-c8a7-4dc3-b9ac-0f7841e1c3ef",
"user": null,
"schoolID": "1000000607",
"modules": 2,
"projectID": null,
"role": null,
"permissions": "all"
}
],
"pageSize": 0,
"pageIndex": 0,
"totalCount": 0
}
https://ty.hxhh.tech/hhtc/api/TC001097/Divisions
{
"result": 0,
"message": "",
"queryObjects": [
{
"id": "650100",
"name": "乌鲁木齐市",
"number": "650100",
"bePublic": true,
"parent": "650000",
"fullPath": "新疆维吾尔自治区/乌鲁木齐市",
"memo": null
}
],
"pageSize": 0,
"pageIndex": 1,
"totalCount": 1
}
https://ty.hxhh.tech/hhtc/api/TC001097/Facilitys
{
"result": 0,
"message": "",
"queryObjects": [
{
"id": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"name": "吐鲁番市高昌区艾丁湖镇也木什小学",
"number": "126",
"minGrade": 11,
"maxGrade": 16,
"divisionID": null,
"parentPath": null,
"tags": 1,
"natoure": 1,
"year": null,
"memo": null,
"location": null,
"schoolId": null,
"appKey": null,
"appSecret": null
},
{
"id": "33ee4ddf-8333-4f97-8bf3-1e417b81f2cf",
"name": "乌鲁木齐市147中学",
"number": "1920699779923480578",
"minGrade": 11,
"maxGrade": 16,
"divisionID": null,
"parentPath": null,
"tags": 1,
"natoure": 1,
"year": null,
"memo": null,
"location": null,
"schoolId": null,
"appKey": null,
"appSecret": null
}
],
"pageSize": 0,
"pageIndex": 1,
"totalCount": 2
}
https://ty.hxhh.tech/hhtc/api/TC001097/StudentClasss
{
"result": 0,
"message": "",
"queryObjects": [
{
"id": "26c5510c-867f-4fea-bb14-7c31efe10437",
"name": "1班",
"beginYear": 2025,
"beginGrade": 11,
"years": 6,
"grade": 11,
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"number": "101",
"professional": "",
"professionalCode": ""
},
{
"id": "3ed0c80d-5372-4d72-967b-d1e88176098c",
"name": "1班",
"beginYear": 2024,
"beginGrade": 11,
"years": 6,
"grade": 12,
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"number": "101",
"professional": "",
"professionalCode": ""
},
{
"id": "7a42526b-161d-4753-98cd-905fd2783084",
"name": "2班",
"beginYear": 2024,
"beginGrade": 11,
"years": 6,
"grade": 12,
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"number": "102",
"professional": "",
"professionalCode": ""
},
{
"id": "234e9460-c5c0-4e4a-8992-4abb2a85b0fd",
"name": "1班",
"beginYear": 2023,
"beginGrade": 11,
"years": 6,
"grade": 13,
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"number": "101",
"professional": "",
"professionalCode": ""
},
{
"id": "c8f0f213-7cde-49a8-ae60-c853748f5b44",
"name": "2班",
"beginYear": 2023,
"beginGrade": 11,
"years": 6,
"grade": 13,
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"number": "102",
"professional": "",
"professionalCode": ""
},
{
"id": "b5dbfe51-6738-4713-9af6-824b6ca044aa",
"name": "1班",
"beginYear": 2022,
"beginGrade": 11,
"years": 6,
"grade": 14,
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"number": "101",
"professional": "",
"professionalCode": ""
},
{
"id": "e1ead7c5-fb92-4eac-b734-38ca72631747",
"name": "2班",
"beginYear": 2022,
"beginGrade": 11,
"years": 6,
"grade": 14,
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"number": "102",
"professional": "",
"professionalCode": ""
},
{
"id": "0984b052-ab2f-4ac9-adbb-efc9c6b612b5",
"name": "1班",
"beginYear": 2021,
"beginGrade": 11,
"years": 6,
"grade": 15,
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"number": "101",
"professional": "",
"professionalCode": ""
},
{
"id": "90047577-9224-45aa-8b19-85936df77428",
"name": "2班",
"beginYear": 2021,
"beginGrade": 11,
"years": 6,
"grade": 15,
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"number": "102",
"professional": "",
"professionalCode": ""
},
{
"id": "2634d818-a464-458e-88f8-d8e89b48ef38",
"name": "1班",
"beginYear": 2020,
"beginGrade": 11,
"years": 6,
"grade": 16,
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"number": "101",
"professional": "",
"professionalCode": ""
},
{
"id": "8a18d249-cebc-4ef6-966a-127bc80a2c6b",
"name": "2班",
"beginYear": 2020,
"beginGrade": 11,
"years": 6,
"grade": 16,
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"number": "102",
"professional": "",
"professionalCode": ""
},
{
"id": "e5abd2f7-2a17-4c9f-917f-a69ceb3e7afb",
"name": "小学一年级1班",
"beginYear": 2025,
"beginGrade": 11,
"years": 6,
"grade": 11,
"facilityID": "33ee4ddf-8333-4f97-8bf3-1e417b81f2cf",
"facilityName": "乌鲁木齐市147中学",
"number": "101",
"professional": "",
"professionalCode": ""
},
{
"id": "0c7ab17c-3103-4526-b932-09b986333719",
"name": "小学一年级2班",
"beginYear": 2025,
"beginGrade": 11,
"years": 6,
"grade": 11,
"facilityID": "33ee4ddf-8333-4f97-8bf3-1e417b81f2cf",
"facilityName": "乌鲁木齐市147中学",
"number": "102",
"professional": "",
"professionalCode": ""
},
{
"id": "c09d9f9b-c65b-45f1-a816-41d8a0b99386",
"name": "小学一年级3班",
"beginYear": 2025,
"beginGrade": 11,
"years": 6,
"grade": 11,
"facilityID": "33ee4ddf-8333-4f97-8bf3-1e417b81f2cf",
"facilityName": "乌鲁木齐市147中学",
"number": "103",
"professional": "",
"professionalCode": ""
},
{
"id": "cc1ef56a-ec4b-4634-9dbb-5d74494a11b9",
"name": "小学一年级4班",
"beginYear": 2025,
"beginGrade": 11,
"years": 6,
"grade": 11,
"facilityID": "33ee4ddf-8333-4f97-8bf3-1e417b81f2cf",
"facilityName": "乌鲁木齐市147中学",
"number": "104",
"professional": "",
"professionalCode": ""
},
{
"id": "a2a189aa-13ac-4588-8be9-8bcd290c29e0",
"name": "小学一年级5班",
"beginYear": 2025,
"beginGrade": 11,
"years": 6,
"grade": 11,
"facilityID": "33ee4ddf-8333-4f97-8bf3-1e417b81f2cf",
"facilityName": "乌鲁木齐市147中学",
"number": "105",
"professional": "",
"professionalCode": ""
},
{
"id": "d79bcd44-c9e8-403d-a649-0a477b8811bd",
"name": "小学一年级6班",
"beginYear": 2025,
"beginGrade": 11,
"years": 6,
"grade": 11,
"facilityID": "33ee4ddf-8333-4f97-8bf3-1e417b81f2cf",
"facilityName": "乌鲁木齐市147中学",
"number": "106",
"professional": "",
"professionalCode": ""
},
{
"id": "72575710-c55f-42d6-abd6-9b9c2f34d842",
"name": "小学二年级1班",
"beginYear": 2024,
"beginGrade": 11,
"years": 6,
"grade": 12,
"facilityID": "33ee4ddf-8333-4f97-8bf3-1e417b81f2cf",
"facilityName": "乌鲁木齐市147中学",
"number": "101",
"professional": "",
"professionalCode": ""
}
],
"pageSize": 0,
"pageIndex": 1,
"totalCount": 18
}
"queryObjects": [
{
"id": "81100010000000003",
"name": "麦尔哈巴·艾尼娃尔",
"sex": 2,
"grade": 11,
"state": 0,
"birthDay": "2016-12-29T00:00:00",
"idNumber": "",
"cardID": null,
"nation": null,
"district": null,
"classID": "26c5510c-867f-4fea-bb14-7c31efe10437",
"classNumber": "101",
"className": "1班",
"professional": "",
"professionalCode": "",
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"schoolNum": "126",
"facilityTags": 1,
"facilityNatoure": 1,
"divisionID": null,
"divisionName": null,
"address": null,
"highSchool": null,
"ropeNumber": null,
"ropeCode": null,
"hasPhoto": true,
"checkTime": null,
"channel": null,
"age": 9
},
上传学生结果
https://ty.hxhh.tech/hhtc/api/TC001097/studentscores/batchadd?option=2
type: post
[
{
"CreateTime": "Sep 16, 2025 10:43:01",
"EndTime": "Sep 16, 2025 10:42:53",
"For": false,
"HostID": 20,
"HostSn": "6D587F96",
"ID": "6adcc622b2ca48ba9f1dc4eee286d786",
"PeripheralCode": "1",
"Score": 27700,
"ScoreFrom": 1,
"ScoreSer": 1,
"Sex": "",
"StartTime": "Sep 16, 2025 10:42:46",
"StudentID": "123456123456",
"StudentName": "",
"TestID": 4,
"scorePosFlag": 0
},
{
"CreateTime": "Sep 16, 2025 10:43:01",
"EndTime": "Sep 16, 2025 10:42:57",
"For": false,
"HostID": 20,
"HostSn": "6D587F96",
"ID": "d5e3ac70846942e8a4592ac98850a8ec",
"PeripheralCode": "1",
"Score": 59100,
"ScoreFrom": 1,
"ScoreSer": 2,
"Sex": "",
"StartTime": "Sep 16, 2025 10:42:54",
"StudentID": "123456123456",
"StudentName": "",
"TestID": 4,
"scorePosFlag": 0
}
]
云端结果查询
url: https://ty.hxhh.tech/hhtc/api/TC001097/StudentWithTotals/?q=eyJTdHVkZW50SURMaWtlIjoiMDAzMiIsInBhZ2VJbmRleCI6MX0%3D%0A
type: "get",
https://ty.hxhh.tech/hhtc/api/TC001097/StudentWithTotals/?q=eyJOb3RUZXN0SXRlbSI6MSwiVGVzdFN0YXRlcyI6WzFdLCJUb3RhbEVxdWFsQW5kVGhhbiI6NTAs%0AIlRvdGFsTGVzc1RoYW4iOjUwLCJUb3RhbFJhbmtzIjpbMSwyLDMsNF0sIkNsYXNzSUQiOiIzZWQw%0AYzgwZC01MzcyLTRkNzItOTY3Yi1kMWU4ODE3NjA5OGMiLCJGYWNpbGl0eUlEIjoiMDU1OWRjNGEt%0AOTExNy00MWJlLWIyYjMtODUyZDI3ZTc3NzlkIiwiR3JhZGUiOjEyLCJOYW1lIjoi6JGj5aOr5p2w%0AIiwiU2V4IjoxLCJTdHVkZW50SURMaWtlIjoiMDAwOSIsInBhZ2VJbmRleCI6MSwicGFnZVNpemUi%0AOjMwLCJzb3J0TW9kZSI6MH0%3D%0A
https://ty.hxhh.tech/hhtc/api/TC001097/StudentWithTotals/?q=eyJUZXN0U3RhdGVzIjpbMl0sInBhZ2VJbmRleCI6MSwicGFnZVNpemUiOjMwLCJzb3J0TW9kZSI6%0AMH0%3D%0A
https://ty.hxhh.tech/hhtc/api/TC001097/StudentWithTotals/?q=eyJUZXN0U3RhdGVzIjpbMF0sInBhZ2VJbmRleCI6MSwicGFnZVNpemUiOjMwLCJzb3J0TW9kZSI6%0AMH0%3D%0A
{
"NotTestItem" : 1, //汇海项目编号
"TestStates" : [ 1 ], //0：未测试，1：未完成测试，2：测试完成。
"TotalEqualAndThan" : 50,
"TotalLessThan" : 50,
"TotalRanks" : [ 1, 2, 3, 4 ],//优秀、良好、及格、不及格
"ClassID" : "3ed0c80d-5372-4d72-967b-d1e88176098c",
"FacilityID" : "0559dc4a-9117-41be-b2b3-852d27e7779d",
"Grade" : 12, //年级编号
"Name" : "董士杰",
"Sex" : 1,
"StudentIDLike" : "0009",
"pageIndex" : 1,
"pageSize" : 30,
"sortMode" : 0
}
{
"result": 0,
"message": "",
"queryObjects": [
{
"total": 37.2,
"jiafen": 0.0,
"rank": 4,
"testState": 1,
"scores": [
{
"testID": 4,
"testTime": "2025-09-08T10:06:49",
"formatScore": "798",
"rawScore": 798.0000,
"result": 68.0000,
"jiafen": 0.0000,
"rank": "及格"
},
{
"testID": 7,
"testTime": "2025-09-11T12:01:30",
"formatScore": "16.9",
"rawScore": 16.9000,
"result": 90.0000,
"jiafen": 0.0000,
"rank": "优秀"
}
],
"appraise": null,
"sportSuggestion": null,
"id": "81100320000000003",
"name": "热依拉·沙迪克",
"sex": 2,
"grade": 11,
"state": 0,
"birthDay": "2016-10-19T00:00:00",
"idNumber": "",
"cardID": null,
"nation": null,
"district": null,
"classID": "26c5510c-867f-4fea-bb14-7c31efe10437",
"classNumber": "101",
"className": "1班",
"professional": "",
"professionalCode": "",
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"schoolNum": "126",
"facilityTags": 1,
"facilityNatoure": 1,
"divisionID": null,
"divisionName": null,
"address": null,
"highSchool": null,
"ropeNumber": null,
"ropeCode": null,
"hasPhoto": true,
"checkTime": null,
"channel": null,
"age": 9
},
{
"total": 0.0,
"jiafen": 0.0,
"rank": 4,
"testState": 0,
"scores": [],
"appraise": null,
"sportSuggestion": null,
"id": "81200320000000003",
"name": "董士杰",
"sex": 2,
"grade": 12,
"state": 0,
"birthDay": "1998-10-29T00:00:00",
"idNumber": "",
"cardID": null,
"nation": null,
"district": null,
"classID": "3ed0c80d-5372-4d72-967b-d1e88176098c",
"classNumber": "101",
"className": "1班",
"professional": "",
"professionalCode": "",
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"schoolNum": "126",
"facilityTags": 1,
"facilityNatoure": 1,
"divisionID": null,
"divisionName": null,
"address": null,
"highSchool": null,
"ropeNumber": null,
"ropeCode": null,
"hasPhoto": false,
"checkTime": null,
"channel": null,
"age": 27
},
{
"total": 0.0,
"jiafen": 0.0,
"rank": 4,
"testState": 0,
"scores": [],
"appraise": null,
"sportSuggestion": null,
"id": "81300320000000003",
"name": "艾力凯木江·艾热提",
"sex": 1,
"grade": 13,
"state": 0,
"birthDay": "2014-10-15T00:00:00",
"idNumber": "",
"cardID": null,
"nation": null,
"district": null,
"classID": "c8f0f213-7cde-49a8-ae60-c853748f5b44",
"classNumber": "102",
"className": "2班",
"professional": "",
"professionalCode": "",
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"schoolNum": "126",
"facilityTags": 1,
"facilityNatoure": 1,
"divisionID": null,
"divisionName": null,
"address": null,
"highSchool": null,
"ropeNumber": null,
"ropeCode": null,
"hasPhoto": false,
"checkTime": null,
"channel": null,
"age": 11
},
{
"total": 0.0,
"jiafen": 0.0,
"rank": 4,
"testState": 0,
"scores": [],
"appraise": null,
"sportSuggestion": null,
"id": "81400320000000003",
"name": "阿比达·阿布都力",
"sex": 2,
"grade": 14,
"state": 0,
"birthDay": "2014-01-13T00:00:00",
"idNumber": "",
"cardID": null,
"nation": null,
"district": null,
"classID": "e1ead7c5-fb92-4eac-b734-38ca72631747",
"classNumber": "102",
"className": "2班",
"professional": "",
"professionalCode": "",
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"schoolNum": "126",
"facilityTags": 1,
"facilityNatoure": 1,
"divisionID": null,
"divisionName": null,
"address": null,
"highSchool": null,
"ropeNumber": null,
"ropeCode": null,
"hasPhoto": false,
"checkTime": null,
"channel": null,
"age": 11
},
{
"total": 0.0,
"jiafen": 0.0,
"rank": 4,
"testState": 0,
"scores": [],
"appraise": null,
"sportSuggestion": null,
"id": "81500320000000003",
"name": "玉山·帕它尔",
"sex": 1,
"grade": 15,
"state": 0,
"birthDay": "2013-08-12T00:00:00",
"idNumber": "",
"cardID": null,
"nation": null,
"district": null,
"classID": "0984b052-ab2f-4ac9-adbb-efc9c6b612b5",
"classNumber": "101",
"className": "1班",
"professional": "",
"professionalCode": "",
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"schoolNum": "126",
"facilityTags": 1,
"facilityNatoure": 1,
"divisionID": null,
"divisionName": null,
"address": null,
"highSchool": null,
"ropeNumber": null,
"ropeCode": null,
"hasPhoto": false,
"checkTime": null,
"channel": null,
"age": 12
},
{
"total": 0.0,
"jiafen": 0.0,
"rank": 4,
"testState": 0,
"scores": [],
"appraise": null,
"sportSuggestion": null,
"id": "81600320000000003",
"name": "沙力·沙拉木",
"sex": 1,
"grade": 16,
"state": 0,
"birthDay": "2011-10-28T00:00:00",
"idNumber": "",
"cardID": null,
"nation": null,
"district": null,
"classID": "8a18d249-cebc-4ef6-966a-127bc80a2c6b",
"classNumber": "102",
"className": "2班",
"professional": "",
"professionalCode": "",
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"schoolNum": "126",
"facilityTags": 1,
"facilityNatoure": 1,
"divisionID": null,
"divisionName": null,
"address": null,
"highSchool": null,
"ropeNumber": null,
"ropeCode": null,
"hasPhoto": false,
"checkTime": null,
"channel": null,
"age": 14
},
{
"total": 0.0,
"jiafen": 0.0,
"rank": 4,
"testState": 0,
"scores": [],
"appraise": null,
"sportSuggestion": null,
"id": "81100320000072043",
"name": "刘笑蕊",
"sex": 2,
"grade": 11,
"state": 0,
"birthDay": "2017-08-13T00:00:00",
"idNumber": "",
"cardID": null,
"nation": null,
"district": null,
"classID": "e5abd2f7-2a17-4c9f-917f-a69ceb3e7afb",
"classNumber": "101",
"className": "小学一年级1班",
"professional": "",
"professionalCode": "",
"facilityID": "33ee4ddf-8333-4f97-8bf3-1e417b81f2cf",
"facilityName": "乌鲁木齐市147中学",
"schoolNum": "1920699779923480578",
"facilityTags": 1,
"facilityNatoure": 1,
"divisionID": null,
"divisionName": null,
"address": null,
"highSchool": null,
"ropeNumber": null,
"ropeCode": null,
"hasPhoto": false,
"checkTime": null,
"channel": null,
"age": 8
},
{
"total": 0.0,
"jiafen": 0.0,
"rank": 4,
"testState": 0,
"scores": [],
"appraise": null,
"sportSuggestion": null,
"id": "81200320000072043",
"name": "王馨玉",
"sex": 2,
"grade": 12,
"state": 0,
"birthDay": "2016-05-05T00:00:00",
"idNumber": "",
"cardID": null,
"nation": null,
"district": null,
"classID": "72575710-c55f-42d6-abd6-9b9c2f34d842",
"classNumber": "101",
"className": "小学二年级1班",
"professional": "",
"professionalCode": "",
"facilityID": "33ee4ddf-8333-4f97-8bf3-1e417b81f2cf",
"facilityName": "乌鲁木齐市147中学",
"schoolNum": "1920699779923480578",
"facilityTags": 1,
"facilityNatoure": 1,
"divisionID": null,
"divisionName": null,
"address": null,
"highSchool": null,
"ropeNumber": null,
"ropeCode": null,
"hasPhoto": false,
"checkTime": null,
"channel": null,
"age": 9
}
],
"pageSize": 0,
"pageIndex": 1,
"totalCount": 8
}
人脸特征值下载
url: "https://ty.hxhh.tech/hhtc/api/TC001097/StudentWithFaceFeatures/?q=eyJoYXNGYWNlRmVhdHVyZSI6dHJ1ZSwiSGFzUGhvdG8iOnRydWUsInBhZ2VJbmRleCI6MSwicGFn%0AZVNpemUiOjEwMH0%3D%0A"
type: "get"
{
"result": 0,
"message": "",
"queryObjects":[
{
"faceFeature": "XXX",
"faceFeatureRec":"XXX",
"id": "81100010000000003",
"name": "麦尔哈巴·艾尼娃尔",
"sex": 2,
"grade": 11,
"state": 0,
"birthDay": "2016-12-29T00:00:00",
"idNumber": "",
"cardID": null,
"nation": null,
"district": null,
"classID": "26c5510c-867f-4fea-bb14-7c31efe10437",
"classNumber": "101",
"className": "1班",
"professional": "",
"professionalCode": "",
"facilityID": "0559dc4a-9117-41be-b2b3-852d27e7779d",
"facilityName": "吐鲁番市高昌区艾丁湖镇也木什小学",
"schoolNum": "126",
"facilityTags": 1,
"facilityNatoure": 1,
"divisionID": null,
"divisionName": null,
"address": null,
"highSchool": null,
"ropeNumber": null,
"ropeCode": null,
"hasPhoto": true,
"checkTime": null,
"channel": null,
"age": 9
},
],
"pageSize": 100,
"pageIndex": 1,
"totalCount": 3
获取学生照片
url: "https://ty.hxhh.tech/hhtc/api/TC001097/StudentPhotos/81100010000000003",
type: "get"
{
result: "0",
message: "",
queryObject: {
id: 81100010000000003,
name: null,
photo: "base64",
faceFeature: "XXX",
faceFeatureRec: "CCC"
}
}
获取设备SN
url: "https://ty.hxhh.tech/hhcrm/api/hhdevices/getbysn?sn=db%3Ab2%3A5d%3Aa7%3Aa4%3A5e",
type: "get"
{
"result": 0,
"message": null,
"queryObject": {
"id": "DB:B2:5D:A7:A4:5E",
"deviceType": 5,
"createTime": "2022-11-14T17:32:03.617",
"serialNumber": "HXHH65CA220600153",
"version": "",
"hardwareVersion": null,
"imei": "863320047685506",
"mac": "db:b2:5d:a7:a4:5e",
"faceCode": "0857-11FA-M2DF-EFDX",
"speechCode": null,
"batchNo": "",
"manufactureDate": null,
"city": "鄂尔多斯市源启教育培训有限公司",
"expireDate": null,
"userID": null,
"deviceName": "",
"activeTime": "2025-09-16T16:19:57",
"lastConnectTime": null,
"lastLocation": null,
"physicalItems": null
}
}
{
"result": 0,
"message": null,
"queryObject": {
"id": "00:60:6E:D4:C6:3F",
"deviceType": 5,
"createTime": "2025-04-09T10:19:11.523",
"serialNumber": "HXHH65CA24050912",
"version": null,
"hardwareVersion": null,
"imei": "863320053081210",
"mac": "00:60:6e:d4:c6:3f",
"faceCode": "0857-11WB-1XPU-VBQZ",
"speechCode": null,
"batchNo": null,
"manufactureDate": null,
"city": null,
"expireDate": null,
"userID": null,
"deviceName": null,
"activeTime": "2025-05-06T14:05:29",
"lastConnectTime": null,
"lastLocation": null,
"physicalItems": null
}
}