統測活動
Jeff 于 2 月之前 修改了此页面

目錄

取得統測活動

URL:{IES5 Domain}/joint/event/find
AD授權:IES、Community
輸入:

{
    "jointEventId": "37db8a66-660c-43a5-b8ce-6686c070973e", //[非必須] 統測活動ID
    "creatorId": "1595321354", //[非必須] 創建者TMID ※此TMID為此次活動的主Blob容器
    "name": "活動", //[非必須] 活動名稱 ※模糊查詢
    "progress": "going", //[非必須] 進行狀況 "pending" "going" "finish"
    "geo": { //[非必須] 地理位置
        "countryId": "TW",  //國家地區代碼
        "cityId":"30" //市代碼
    },
    "isMarking": true //[非必須] 閱卷模式 ※會只列出"有進行中的評量活動行程且該活動的群組評審包含使用者"的統測活動
}

回傳值

{
    "data": [
        {
            "id": "37db8a66-660c-43a5-b8ce-6686c070973e", //活動ID
            "code": "JointEvent",
            "pk": "JointEvent",
            "creatorId": "1595321354", //活動創建人
            "name": "統測活動",
            "geo": { //區域限制
                "countryId": "TW",
                "provinceId": null,
                "cityId": "30",
                "distId": null
            },
            "admin": [ //管理者
                "1595321354"
            ],
            "groups": [ //組別
                {
                    "id": "55edeec3-a3cd-4117-b2e1-4e10c5b3d651",
                    "name": "低年級",
                    "assistants": [ //評審
                        "1595321354"
                    ]
                }
            ],
            "schedule": [ //活動行程
                {
                    "id": "52dfd7bb-27d6-49f5-bfc5-9243e97d64cd",
                    "name": "報名",
                    "type": "join",
                    "examType": null,
                    "examOverwrite": false,
                    "blobs": [ //文件Blob位置列表
                        {
                            "name": "報名規則", //文件名
                            "blob": "/jointevent/db94a758-7d68-4f23-8f45-dd864e63b2b9/schedule/0483105c-00a9-460a-bad1-c45ea7df459d/報名方法.zip" //文件Blob位址 ※/jointevent/{統測活動ID}/schedule/{活動行程ID}/檔案名稱
                        }
                    ],
                    "location": "線上報名", //地點
                    "description": "以班級為單位報名,導師或授課教師在此報名平台選取參賽班級與名單。", //說明
                    "startTime": 1719221320041,
                    "endTime": 1719307720042,
                    "progress": "finish"
                },
                {
                    "id": "d2dc82cb-f450-416c-ade4-5c3c005fafb6",
                    "name": "賽前賽",
                    "type": "exam", //行程類型 "join":報名 "exam":評量 "other":其他
                    "examType": "regular", //評量類型 "regular":一般競賽 "custom":挑戰賽
                    "examOverwrite": true, //重複作答 true:可 false:不可
                    "blobs": null,
                    "location": null,
                    "description": null,
                    "startTime": 1718702920041,
                    "endTime": 1718875720041,
                    "progress": "finish"
                }
            ],
            "examLinkType": "no", //評量連動類型 "no":未參加熱身賽也可以參加決賽 ※預設值  "one":熱身賽完成任一場就可以參加決賽  "all":熱身賽全完成才可以參加決賽 
            "createTime": 1718357320040,
            "startTime": 1718357320040,
            "endTime": 1719307720040,
            "progress": "going",
            "blobsas": "sv=2024-05-04&st=2024-08-02T09%3A38%3A23Z&" //Blob取得Token
        }
    ]
}

新增修改統測活動

URL:{IES5 Domain}/joint/event/upsert
輸入:

{
    "creatorId": "1595123456", //[必須] 創建者TMID
    "name":"統測活動", //[必須] 活動名稱
    "startTime": 1718357320040, //[必須] 起始時間
    "endTime":1719307720040, //[必須] 終止時間
    "geo": //[非必須] 區域限制
        {
            "countryId":"TW", 
            "cityId":"30"
        },
    "admin": ["1595321354"], //[非必須] 管理者
    "jointEventId":"d3753314-03a3-4cbe-b7f6-0dd5a3a3c8a6" //[非必須] 活動ID,有則更新、無則新建。 ※若有給活動ID卻無法取得該活動,則回傳錯誤訊息
}

回傳值

{ 
    "errCode": "", 
    "err": "",
    "jointEvent": { //活動內容
        "creatorId": "1595321354",
            "name": "統測活動(測試三)",
            ...[略]
    }
}

新增修改統測活動分組

URL:{IES5 Domain}/joint/event-group/upsert
輸入:

{
    "jointEventId":"6e330362-db01-47b4-b113-6afea05e942e", //[必須] 活動ID
    "groups":[ //[必須] 活動分組
        {
            "id":"86b49f79-b614-45e7-a386-5e9dd3b91fb5", //分組ID 若給空值則會新增
            "name":"高年級", //分組名稱
            "assistants":["1595321354"] //評審TMID
        }
    ]
}

回傳值

{ 
    "errCode": "", 
    "err": "",
    "jointEvent": { //活動內容
        "creatorId": "1595321354",
            "name": "統測活動(測試三)",
            ...[略]
    }
}

刪除統測活動分組

URL:{IES5 Domain}/joint/event-group/delete
輸入:

{
    "jointEventId":"6e330362-db01-47b4-b113-6afea05e942e", //[必須] 活動ID
    "groupId":"867a9f89-e600-42e7-8e15-2e299d862488" //[必須] 分組ID
}

回傳值

{ 
    "errCode": "", 
    "err": "",
    "jointEvent": { //活動內容
        "creatorId": "1595321354",
            "name": "統測活動(測試三)",
            ...[略]
    }
}

新增修改活動行程

URL:{IES5 Domain}/joint/schedule/upsert
輸入:

{
    "jointEventId":"37db8a66-660c-43a5-b8ce-6686c070973e", //[必須] 活動ID
    "schedules": [ //[必須] 活動行程
        {
            "type":"exam", //行程類型 "exam":評量 "join":報名 "other":其他
            "examType":"regular", //評量類型 "regular":一般競賽 "custom":決賽 "other":其他(挑戰賽)
            "examOverwrite": false, //評量可否重複作答 true:可 
            "id":"d2dc82cb-f450-416c-ade4-5c3c005fafb6", //行程ID 若給空值則會新增
            "name":"熱身賽", //行程名稱
            "location": "線上報名", //[非必須]地點
            "description": "線上報名", //[非必須]說明
            "blobs": [ //[非必須]文件Blob位置列表 ※無則預設為null
                {
                    "name":"報名規則", //文件名稱
                    "blob":"/jointevent/db94a758-7d68-4f23-8f45-dd864e63b2b9/schedule/0483105c-00a9-460a-bad1-c45ea7df459d/報名方法.zip" //文件Blob位址 ※/jointevent/{統測活動ID}/schedule/{活動行程ID}/檔案名稱
                }
            ],
            "startTime": 1718702920041,  //起始時間
            "endTime": 1718875720041, //結束時間
            "orderby":1 //排序
        }
    ]
}

回傳值

{ 
    "errCode" = "", 
    "err" = "",
    "jointEvent": { //活動內容
        "creatorId": "1595321354",
            "name": "統測活動(測試三)",
            ...[略]
    }
}

刪除活動行程

URL:{IES5 Domain}/joint/schedule/delete
輸入:

{
    "jointEventId":"37db8a66-660c-43a5-b8ce-6686c070973e", //[必須] 活動ID
    "scheduleId":"d8a7ae5c-2287-4e89-8775-fb7ff877c506" //[必須] 行程ID
}

回傳值

{ 
    "errCode" = "", 
    "err" = "",
    "jointEvent": { //活動內容
        "creatorId": "1595321354",
            "name": "統測活動(測試三)",
            ...[略]
    }
}

取得統測教師課程及組別

URL:{IES5 Domain}/joint/course/find
AD授權:IES、Community
輸入:

{
    "jointEventId":"37db8a66-660c-43a5-b8ce-6686c070973e", //[必須] 活動ID
    "jointGroupId":"55edeec3-a3cd-4117-b2e1-4e10c5b3d651", //[非必須] 組別ID
    "creatorId":"1595321354", //[非必須] 創建者(報名者)ID
    "type":"1595321354" //[非必須] 類型 "regular":老師報名課程名單 "custom":決賽老師課程名單 ※未給值預設為"regular"
}

回傳值

{
    "data": [
        {
            "jointEventId": "37db8a66-660c-43a5-b8ce-6686c070973e", //活動ID
            "jointGroupId": "55edeec3-a3cd-4117-b2e1-4e10c5b3d651", //組別ID
            "id": "23f2fc0b-c881-43d2-8679-754bd965bb09", //ID ※一個活動一個組別一位老師生成一個檔案
            "code": "JointCourse",
            "pk": "JointCourse",
            "scope": "private",
            "creatorId": "1522758684",
            "creatorName": "DaTou  Fu",
            "schoolId": null,
            "periodId": null,
            "courseLists": [
                {
                    "subjectId": null,
                    "courseId": "424eb44d-8904-4e34-bfaf-e138f8e369cb",
                    "courseName": "1522758684個人課程",
                    "groupLists": [
                        {
                            "id": "5bf63f35-f82f-432e-9b78-a4f38b5edb81",
                            "name": "暑期班",
                            "stuNum": 2, //實際學生數
                            "expStuNum": 25, //預估學生人數 ※2025-3-14追加
                            "goFinal": true, //是否可晉級決賽
                            "schedule": [ //活動行程進行狀況
                                {
                                    "id": "33fbcf24-d452-448e-9207-58268250bf6a", //活動行程ID
                                    "name": "報名", //活動行程名稱
                                    "status": "complete" //活動行程進行狀況 "complete":已完成 "doing":進行中 "undo":未進行 "disqualify":資格不符
                                }
                            ]
                        }
                    ]
                }
            ],
            "ttl": -1,
            "_ts": 1720601293,
        }
    ]

新建修改教師課程及組別

URL:{IES5 Domain}/joint/course/upsert
AD授權:IES、Community
輸入:

{
    "jointEventId":"37db8a66-660c-43a5-b8ce-6686c070973e", //[必須] 活動ID
    "jointGroupId":"55edeec3-a3cd-4117-b2e1-4e10c5b3d651", //[必須] 組別ID
    "creatorId":"1595321354", //[必須] 創建者(報名者)TMID
    "creatorName":"Rocket Man",  //[必須] 創建者名
    "creatorEmail":"test@gmail.com",  //[必須] 創建者Email
    "schoolId": "habook", //[非必須] 學校簡碼 ※無值會記入空字串
    "schoolName": "玉山學校", //[非必須] 學校名稱 ※無值會記入空字串
    "countryId": "TW",
    "countryName": "臺灣",
    "provinceId": "",
    "provinceName": "",
    "cityId": "01",
    "cityName": "新北市",
    "scope": "private", //[必須] 個人/學校 "private":個人 "school":學校
    "courseLists": [ //[必須] 課程列表
        {
            "subjectId": null, //科目ID ※預留給學校班級用,個人課程記入null
            "courseId": "e1d817e5-71b3-bc50-52ac-fa828e5f38d6", //課程ID
            "courseName": "英文一", //課程名稱
            "groupLists": [ //課程名單(分組)
                {
                    "id": "4dd434a8-a94a-4373-9a05-1a1add533a71", //課程名單ID
                    "name": "A班", //課程名單名稱
                    "expStuNum": 25 //預估學生人數 ※2025-3-14追加
                }
                {
                    "id": "b9163351-289e-4078-a3b7-fa336f43bcfd",
                    "name": "B班",
                    "expStuNum": 20
                }
            ]
        }
    ]}

回傳值

{
    "errCode": "",
    "err": "",
    "jointCourse": {
        "jointEventId": "37db8a66-660c-43a5-b8ce-6686c070973e",
        "jointGroupId": "55edeec3-a3cd-4117-b2e1-4e10c5b3d651",
        "id": "6ff3ce6a-85cc-4421-b85d-388966e527d5",
        "code": "JointCourse",
        "pk": "JointCourse",
        "scope": "private",
        "creatorId": "1595321354",
        "creatorName": "Rocket Man",
        "schoolId": "habook",
        "periodId": null,
        "countryId": "TW",
        "countryName": "臺灣",
        "provinceId": "",
        "provinceName": "",
        "cityId": "01",
        "cityName": "新北市",
        "courseLists": [
            {
                "subjectId": null,
                "courseId": "e1d817e5-71b3-bc50-52ac-fa828e5f38d6",
                "courseName": "test",
                "groupLists": [
                    {
                        "id": "4dd434a8-a94a-4373-9a05-1a1add533a71",
                        "name": "a2",
                        "expStuNum": 25 //預估學生人數 ※2025-3-14追加
                    }
                ]
            },
            {
                "subjectId": null,
                "courseId": "36cbd252-6d36-48d6-b831-27af914b7fa8",
                "courseName": "錯題收集課程",
                "groupLists": [
                    {
                        "id": "b9163351-289e-4078-a3b7-fa336f43bcfd",
                        "name": "B班",
                        "expStuNum": 20
                    }
                ]
            }
        ],
        "ttl": -1,
        "_ts": -1
    }
}

刪除教師課程及組別

URL:{IES5 Domain}/joint/course/delete
輸入:

{
    "jointCourseId":"23f2fc0b-c881-43d2-8679-754bd965bb09" //教師課程組別ID
}

回傳值

{
    "errCode": "",
    "err": ""
}

取得統測評量

URL:{IES5 Domain}/joint/exam/find
AD授權:IES、Community
輸入:

{
    "jointEventId":"37db8a66-660c-43a5-b8ce-6686c070973e", //[必須] 活動ID
    "jointScheduleId": "d2dc82cb-f450-416c-ade4-5c3c005fafb6", //[非必須] 行程ID
    "jointGroupId": "55edeec3-a3cd-4117-b2e1-4e10c5b3d651", //[非必須] 活動分組ID
    "creatorId":"1595321354",  //[非必須] 創建者TMID
    "stime":1718077192588, //[非必須] 時間區間:起始時間 ※createTime欄位大於此值則取
    "etime":1719134547761, //[非必須] 時間區間:終止時間 ※createTime欄位小於此值則取
    "name":"統測", //[非必須] 評量名稱 ※模糊查詢
    "progress":"going", //[非必須] 評量進行狀況 "pending" "going" "finish" 
    "source":"0" //[非必須] 評量類型 "0":線上自主評量 "1":智慧教室評量 "2":卷卡合一評量
    "count": 10, //[非必須] 取得評量數 無值則不限數目
    "token": null //[非必須] 分頁token
}

回傳值

{
    "data": [
        {
            "jointEventId": "37db8a66-660c-43a5-b8ce-6686c070973e",
            "jointScheduleId": "d2dc82cb-f450-416c-ade4-5c3c005fafb6",
            "jointGroupId": "55edeec3-a3cd-4117-b2e1-4e10c5b3d651",
            "creatorId": "1595321354",
            "name": "統測測試(一)",
            "examType": "regular",
            "examOverwrite": true,
            "classes": [],
            "stuLists": [ //老師、課程、課程名單 列表 
                {
                    "scope": "private",
                    "creatorId": "1595321354",
                    "creatorName": "Rocket Man",
                    "schoolId": null,
                    "periodId": null,
                    "courseLists": [ //課程、課程名單 
                        {
                            "subjectId": "e1d817e5-71b3-bc50-52ac-fa828e5f38d6", //科目ID ※個人課程時為課程ID
                            "courseId": "e1d817e5-71b3-bc50-52ac-fa828e5f38d6", //課程ID
                            "courseName": "test", //課程名稱
                            "groupLists": [ //課程名單列表
                                {
                                    "id": "4dd434a8-a94a-4373-9a05-1a1add533a71", //課程名單ID
                                    "name": "a2",
                                    "no": "1" //各活動分組下的班級流水號
                                }
                            ],
                            "examId": "a04cad99-f520-4041-8233-e69dde6c628c" //評測ID ※一個課程ID會生成一個評測ID
                        }
                    ]
                }
            ],
            "papers": [
                {
                    "id": "1c6a1e85-4b34-b8af-00de-a379bc47a26c",
                    "subjectId": null,
                    "code": "Paper-tbslgb",
                    "periodId": null,
                    "name": "語文理解",
                    "blob": "/jointexam/daaa3965-db28-49ae-8074-c9d4865b62ad/paper/1c6a1e85-4b34-b8af-00de-a379bc47a26c",
                    "scope": "school",
                    "multipleRule": 1,
                    "point": [
                        50,
                        50
                    ],
                    "answers": [
                        [
                            "D"
                        ],
                        [
                            "D"
                        ]
                    ],
                    "knowledge": [],
                    "type": [
                        "single",
                        "single"
                    ],
                    "field": [
                        2,
                        2
                    ],
                    "sheet": null,
                    "sheetNo": null,
                    "mode": null,
                    "time": 0
                }
            ],
            "progress": "going",
            "createTime": 1718961747761,
            "updateTime": 0,
            "startTime": 1720454400000,
            "endTime": 1720796400000,
            "source": "0",
            "scope": "private",
            "id": "daaa3965-db28-49ae-8074-c9d4865b62ad",
            "code": "JointExam",
            "pk": null,
            "ttl": -1,
            "_ts": 1720601400
        }
    ],
    "token": null
}

新建變更統測評量

URL:{IES5 Domain}/joint/exam/upsert
輸入:

{
    "jointEventId":"37db8a66-660c-43a5-b8ce-6686c070973e", //[必須] 活動ID
    "jointGroupId":"55edeec3-a3cd-4117-b2e1-4e10c5b3d651", //[必須] 活動分組ID
    "jointScheduleId":"d2dc82cb-f450-416c-ade4-5c3c005fafb6", //[必須] 行程ID
    "jointExamId": "daaa3965-db28-49ae-8074-c9d4865b62ad", //[必須] 如為新建,則需生成新的GUID後放入此欄位
    "creatorId": "1595321354", //[新建評量則必須] 創建者TMID 
    "name":"統測測試", //[新建評量則必須] 評量名稱 
    "source":"0", //[新建評量則必須] 評量類型 "0":線上自主評量 "1":智慧教室評量 "2":卷卡合一評量
    "scope":"private", //[非必須] 學校/個人 若無給值則預設為"private"
    "papers":[ //[新建評量則必須] 試卷 ※需先將試卷內容上傳至Blob,上傳容器為創建者TMID,路徑為/jointexam/{jointExamId}/paper/{paperId}
        {
            "id": "1c6a1e85-4b34-b8af-00de-a379bc47a26c",
            "subjectId": null,
            "code": "Paper-tbslgb",
            "periodId": null,
            "name": "語文理解",
            "blob": "/jointexam/daaa3965-db28-49ae-8074-c9d4865b62ad/paper/1c6a1e85-4b34-b8af-00de-a379bc47a26c",
            "scope": "school",
            "multipleRule": 1,
            "point": [
                50,
                50
            ],
            "answers": [
                [
                    "D"
                ],
                [
                    "D"
                ]
            ],
            "knowledge": [],
            "type": [
                "single",
                "single"
            ],
            "field": [
                2,
                2
            ],
            "sheet": null,
            "sheetNo": null,
            "mode": null,
            "time": 0
        }
    ]
}

回傳值

{
    "errCode": "",
    "err": "",
    "jointExam": { //統測評量
        "jointEventId": "37db8a66-660c-43a5-b8ce-6686c070973e",
        "jointScheduleId": "d2dc82cb-f450-416c-ade4-5c3c005fafb6",
        ...[略]
    }
}

取得學生評量結果

URL:{IES5 Domain}/common/exam/find-summary-record
輸入:

{
  "id": "a04cad99-f520-4041-8233-e69dde6c628c", //評測ID ※可由 [JointExam] stuLists.courseLists.examId 取得
  "code": "1595321354", //老師ID 或 學校簡碼 ※可由 [JointExam] stuLists.creatorId 取得
  "subjectId": "e1d817e5-71b3-bc50-52ac-fa828e5f38d6", //科目ID ※可由 [JointExam] stuLists.courseLists.subjectId 取得
  "classId": "4dd434a8-a94a-4373-9a05-1a1add533a71", //課程名單ID ※可由 [JointExam] stuLists.courseLists.groupLists.id 取得
  "startTime": 1720540800000 //起始時間 ※可由 [JointExam] startTime 取得
}

回傳值

{
    "examClassResults": [
        {
            "school": null,
            "examId": null,
            "subjectId": "e1d817e5-71b3-bc50-52ac-fa828e5f38d6",
            "gradeId": null,
            "year": 0,
            "info": {
                "id": "4dd434a8-a94a-4373-9a05-1a1add533a71",
                "name": "a2",
                "periodId": null,
                "year": 0,
                "no": null
            },
            "progress": false,
            "studentIds": [
                "1522758684"
            ],
            "studentAnswers": [
                []
            ],
            "ans": [],
            "studentScores": [
                [
                    -1,
                    -1
                ]
            ],
            "status": [
                1
            ],
            "mark": [
                [
                    [],
                    []
                ]
            ],
            "scope": null,
            "sum": [],
            "average": 0,
            "srate": 0,
            "standard": 0,
            "krate": [],
            "phc": [],
            "plc": [],
            "pc": [],
            "frate": [],
            "fphc": [],
            "fplc": [],
            "fpc": [],
            "paper": [],
            "id": "5efef2a7-927d-4990-96f1-6af64fdeb76f",
            "code": "ExamClassResult-1595321354",
            "pk": "ExamClassResult",
            "ttl": -1,
            "_ts": -1
        }
    ],
    "ufos": [
        {
            "id": "1522758684",
            "name": "DaTou  Fu",
            "type": 1
        }
    ],
    "delIds": [],
    "markResult":[ //老師批改紀錄結果
        {
            "markerId":"1595321354", //批改老師TMID
            "markerName":"Rocket Man", //批改老師姓名
            "studentIds":[ //學生ID
                "202107001",
                "202107002",
                "202301016"
            ],
            "points":[ //批改分數結果
                [ 6, 12, 5, 20 ], //第1題、第2題...
                [ ], //空則為未批改過
                [ 7, 12, 0, 20 ]
            ],
            "id":"1379e6c3-ee33-49f2-95c5-cebf2c4b6812", //ID ※與examClassResults的ID相同
            "code":"ExamClassResultMark-tbslgb",
            "pk":"ExamClassResultMark",
            "ttl":-1,
            "_ts":1725262024
        }
    ]
}

取得統測活動ClouDas計算結果

URL:{IES5 Domain}/janalysis/process-joint
輸入:

{
    "jointExamId":"f25b7951-3402-dfce-36c8-886d00f3927e" //統測評量ID
}

回傳值

{
    "students": [ //學生資料
        {
            "nickname": "林哲向",
            "id": "1727172153667001",
            "no": "1",
            "name": "林哲向",
            "total": 50,
            "gpr": 0,
            "cpr": 99,
            "csort": 1,
            "gsort": 0,
            "subjects": [ //該學生的課程統計資料
                {
                    "point": [ //各題得分
                        10,
                        20,
                        20,
                        0,
                        0
                    ],
                    "fieldPoint": [ //各認知層次得分
                        0,
                        50,
                        0,
                        0,
                        0,
                        0
                    ],
                    "scatter": [ //落點分析
                        "1727172153667001", //學生ID
                        "安興107", //班級名稱
                        "0",  //穩定度
                        "50", //通過率
                        "1", //此次評量此課程的第幾位學生
                        "50", //得分
                        "3", //答對題數
                        "2", //答錯題數
                        "4,5", //需努力的题型
                        "-", //需小心的题型
                        "B" //落点区域
                    ],
                    "id": "04847a32-258c-4fe9-b9e7-753e008506e8", //課程ID
                    "name": "HiTeach", //課程名稱
                    "gpr": 0, //該科目全年級PR值
                    "cpr": 99,  //該科目班級PR值
                    "score": 50, //總得分
                    "csort": 1,
                    "gsort": 0,
                    "sRate": 50,
                    "scores": [
                        10,
                        20,
                        20,
                        0,
                        0
                    ]
                }
            ],
            "examId": "f80f41b1-7550-4477-9511-ef0aa64bb65e",
            "classId": "76d7a112-61de-4a9f-90c0-40816b879197",
            "className": "安興107",
            "gradeId": null,
            "csRate": 0,
            "sRate": 1.79
        }
    ],
    "classes": [ //班級資料
        {
            "classId": "76d7a112-61de-4a9f-90c0-40816b879197",
            "className": "安興107",
            "creatorId": "1724131978",
            "studentIds": [
                "1727172153667001",
                "1727172153667002",
                "1727172153667003"
            ],
            "gradeId": "",
            "year": 0,
            "stuCount": 29,
            "lineCount": 0, //進線人數
            "totalAverage": 32.69, //總平均分
            "standardDeviation": 12.27, //標準差
            "csRate": 1.17, //得分率
            "fieldPer": [ //各認知層次試卷配分所占分數比率
                "0.00",
                "0.60",
                "0.10",
                "0.00",
                "0.30",
                "0.00"
            ],
            "fScore": [ //各認知層次試卷的配分
                0,
                60,
                10,
                0,
                30,
                0
            ],
            "fieldWrong": [ //各認知層次錯題率相關資料
                [
                    "1", //認知層次編號 1:記憶 2:理解 3:應用 4:分析 5:評鑑 6:創造
                    "0", //試卷配分
                    "", //該認知層次的題號
                    "0", //平均得分率
                    "0", //錯題人次
                    "0", //PH(高分組)錯題人次 ※班級資料的此欄位無法計算,為0
                    "0" //PL(低分組)錯題人次 ※班級資料的此欄位無法計算,為0
                ],
                [
                    "2",
                    "60",
                    "1,3,4",
                    "0",
                    "23",
                    "0",
                    "0"
                ],
                ...(略)
            ],
            "fieldStuPer": [ //每個學生的認知層次取得分數
                {
                    "key": "1706406510", //學生ID
                    "value": [ //各認知層次取得分數
                        0,
                        10,
                        10,
                        0,
                        0,
                        0
                    ]
                },
                {
                    "key": "1706406660",
                    "value": [
                        0,
                        20,
                        0,
                        0,
                        0,
                        0
                    ]
                }
            ],
            "knowName": [ //各知識點名稱
                "讀策",
                "讀二",
                "讀四"
            ],
            "knowPer": [ //各知識點試卷配分所占分數比率
                "0.10",
                "0.60",
                "0.30"
            ],
            "kScore": [ //各知識點試卷的配分
                10,
                60,
                30
            ],
            "knowWrong": [ //各知識點錯題率相關資料
                [
                    "讀策", //知識點名
                    "10", //試卷配分
                    "1", //該知識點的題號
                    "0.28", //平均得分率
                    "14", //錯題人次
                    "0", //PH(高分組)錯題人次 ※班級資料的此欄位無法計算,為0
                    "0" //PL(低分組)錯題人次 ※班級資料的此欄位無法計算,為0
                ],
                [
                    "讀二",
                    "60",
                    "2,3,4",
                    "0.25",
                    "3",
                    "0",
                    "0"
                ]
            ],
            "knowStuPer": [ //每個學生的知識點取得分數
                {
                    "key": "1706406510", //學生ID
                    "value": [ //各知識點取得分數
                        10,
                        10,
                        0
                    ]
                },
                {
                    "key": "1706406660",
                    "value": [
                        0,
                        20,
                        0
                    ]
                }
            ],  
            "subjects": [
                {
                    "id": "04847a32-258c-4fe9-b9e7-753e008506e8",
                    "name": "HiTeach",
                    "point": [
                        9.62,
                        11.54,
                        11.54,
                        0,
                        0
                    ],
                    "field": [ //各認知層次得分
                        0,
                        32.69,
                        0,
                        0,
                        0,
                        0
                    ],
                    "passCount": 0,
                    "passPercent": 0,
                    "average": 32.69,
                    "sRate": 32.69,
                    "standard": 12.27,
                    "item": [
                        96.15,
                        57.69,
                        57.69,
                        0,
                        0
                    ],
                    "krate": [],
                    "phc": [
                        0,
                        0,
                        0,
                        0,
                        0
                    ],
                    "plc": [
                        4,
                        2,
                        0,
                        0,
                        0
                    ],
                    "pc": [],
                    "frate": [],
                    "fphc": [],
                    "fplc": [],
                    "fpc": []
                }
            ]
        }
    ],
    "grades": [],
    "paper": [ //試卷分析 
        {
            "key": "04847a32-258c-4fe9-b9e7-753e008506e8",
            "value": [ //各題資訊 ※各欄位可參閱「試卷分析Key」
                [
                    "1", //題號
                    "single", //題型
                    "A", //落點區域
                    "10", //本題配分
                    "0.9285",  //難易度
                    "0.14300000000000002", //鑑別度
                    "0.962", //班級得分率
                    "76d7a112-61de-4a9f-90c0-40816b879197:96.15", //年級的得分率 格式 {班級ID}:{得分率}
                    "-",
                    "-",
                    "-",
                    "-",
                    "1", //成就區分組1
                    "1", //成就區分組2
                    "1", //成就區分組3
                    "1", //成就區分組4
                    "1", //成就區分組5
                    "0.75", //成就區分組6
                    "1", //高分組得分率
                    "0.857", //低分組得分率
                    "0", //X向量
                    "0.96", //Y向量
                    "讀策", //本題知識點(複數個以逗號分隔)
                    "86.21" //本題得分率
                ]
            ]
        }
    ],
    "subjects": [ //課程(科目)資訊
        {
            "id": "04847a32-258c-4fe9-b9e7-753e008506e8",
            "name": "HiTeach",
            "record": [
                {
                    "A": 25
                },
                {
                    "C": 15,
                    "B": 4,
                    "A": 6
                },
                {
                    "C": 15,
                    "A": 6,
                    "B": 5
                },
                {},
                {}
            ],
            "phc": [
                {
                    "A": 8
                },
                {
                    "C": 7,
                    "B": 1
                },
                {
                    "C": 8
                },
                {},
                {}
            ],
            "plc": [
                {
                    "A": 4
                },
                {
                    "C": 2,
                    "A": 2
                },
                {
                    "B": 4,
                    "A": 1
                },
                {},
                {}
            ],
            "sRate": 32.69,
            "average": 32.69,
            "standard": 12.27
        }
    ],
    "scatterKey": [ //落點分析Key
        "name",
        "className",
        "x",
        "y",
        "memberId",
        "score",
        "trueNum",
        "falseNum",
        "hardList",
        "carefulList",
        "scatter"
    ],
    "paperKey": [ //試卷分析Key
        "id",
        "type",
        "areaName",
        "score",
        "diff",
        "identify",
        "classScoreRate",
        "gradeScoreRate",
        "areaScoreRate",
        "highScoreRate",
        "lowScoreRate",
        "knowledgePoint",
        "R1",
        "R2",
        "R3",
        "R4",
        "R5",
        "R6",
        "PH",
        "PL",
        "X",
        "Y",
        "knowledge",
        "examScoreRate"
    ],
    "pointLevelKey": [
        {},
        {}
    ],
    "ipoint": 201,
    "touchScore": 0,
    "knowKey": [ //知識點Key
        "id",
        "className",
        "seatNO",
        "point",
        "anwPoint",
        "persent"
    ],
    "wrongKey": [ //知識點錯題率Key
        "name",
        "point",
        "itemNO",
        "persent",
        "wrong",
        "rhw",
        "rlw"
    ],
    "wrong": [ //知識點錯題率 
        {
            "key": "04847a32-258c-4fe9-b9e7-753e008506e8", //課程ID
            "value": [ //※各欄位可參閱「知識點錯題率Key」
                [
                    "讀策",
                    "10",
                    "1",
                    "0.96",
                    "4",
                    "0",
                    "4"
                ],
                [
                    "讀二聽",
                    "20",
                    "2",
                    "0.58",
                    "14",
                    "8",
                    "6"
                ]
            ]
        }
    ],
    "knowName": [ //知識點
        {
            "key": "04847a32-258c-4fe9-b9e7-753e008506e8", //課程ID
            "value": [
                "讀策",
                "讀二聽",
                "讀二",
                "讀四寫",
                "讀三"
            ]
        }
    ],
    "knowPer": [ //各知識點所占分数
        {
            "key": "04847a32-258c-4fe9-b9e7-753e008506e8", //課程ID
            "value": [
                "0.10",
                "0.20",
                "0.20",
                "0.30",
                "0.20"
            ]
        }
    ],
    "knowAllper": [ //各知識點平均得了多少分
        {
            "key": "04847a32-258c-4fe9-b9e7-753e008506e8", //課程ID
            "value": [
                8.62,
                10.34,
                10.34,
                0,
                0
            ]
        }
    ],
    "fieldwrong": [ //認知層次錯題率表
        {
            "key": "04847a32-258c-4fe9-b9e7-753e008506e8", //課程ID
            "value": [
                [
                    "1", //認知層次編號
                    "0", //得分
                    "", //屬於該認知層次的題號(以逗號分隔)
                    "0", //"平均得分率"
                    "0", //"錯題人次"
                    "0", //PH(高分組)錯題人次
                    "0" //PL(低分組)錯題人次
                ],
                [
                    "2",
                    "50",
                    "1,2,3",
                    "0.65",
                    "32",
                    "15",
                    "17"
                ]
            ]
        }
    ],
    "fieldName": [ //認知層次名
        {
            "key": "04847a32-258c-4fe9-b9e7-753e008506e8",
            "value": [
                1,
                2,
                3,
                4,
                5,
                6
            ]
        }
    ],
    "fieldPer": [ //每個認知層次所占分数
        {
            "key": "04847a32-258c-4fe9-b9e7-753e008506e8",
            "value": [
                "0.00",
                "0.50",
                "0.30",
                "0.20",
                "0.00",
                "0.00"
            ]
        }
    ],
    "fieldAllPer": [ //每個認知層次平均得了多少分
        {
            "key": "04847a32-258c-4fe9-b9e7-753e008506e8",
            "value": [
                0,
                29.31,
                0,
                0,
                0,
                0
            ]
        }
    ],
    "kScores": [ //每個知識點所得分數
        {
            "key": "04847a32-258c-4fe9-b9e7-753e008506e8",
            "value": [
                10,
                20,
                20,
                30,
                20
            ]
        }
    ],
    "fScores": [ //每個認知層次所得分數
        {
            "key": "04847a32-258c-4fe9-b9e7-753e008506e8",
            "value": [
                0,
                50,
                30,
                20,
                0,
                0
            ]
        }
    ],
    "all": { //總成績
        "allSRate": 37.842068965517235,
        "allAverage": 37.842068965517235,
        "allStandard": 6.052413793103448,
        "total": 685, //學生數
        "lost": 239 //缺考人數
    }
}

取得教師BlobSas

URL:{IES5 Domain}/joint/tblobsas
輸入:

{
    "tmids": ["1522657890","1689763000","1700987654"]
}

回傳值

[
    {
        "id": "1595321354",
        "sas": "sv=2024-05-04&st=2024-08-28T01%3A59%3A57Z&se=2024-08-28aldskgjaoiurasdklblswoej"
    },
    ...
]

取得醍魔豆帳號進階資訊

URL:https://api2.teammodel.net/oauth2/usersetting
輸入:

{
    "grant_type":"get",
    "product":"base-ex", 
    "id_token":"{{id_token}}"
}

回傳值

{
    "name": "罗老师",
    "mobile": "1111222333",
    "countryCode": "86",
    "mail": "123@test.com",
    "unitType": "1",
    "unitName": "HabookRD測試用學校",
    "jobTitle": "博士",
    "country": "TW",
    "province": "30",
    "city": "35",
    "schoolCode": "habkrd", //強歸戶學校ID
    "schoolCodeW": "habook" //弱歸戶學校ID
}

錯誤代碼