Practice API

個人練習相關的API

Endpoints

# Endpoints

POST

/web/practice/assignment-page

# 分配練習分頁

POST

/web/practice

# 分配個人練習

---

Assignment page

分配練習分頁

Request (AssignmentRecordPageFilterReq)

POST /web/practice/assignment-page

{
  "userId": "b84d022d-3280-4f61-aa85-2161ac417d29",
  "statuses": [],
  "pagination": {
    "page": 1,
    "size": 10
  },
  "sortings": []
}

Response (AssignmentRecordPageResp)

{
  "success": true,
  "message": "",
  "data": [
    {
      "pagination": {
        "page": 1,
        "size": 10,
        "totalItems": 1,
        "totalPages": 1
      },
      "sortings": [],
      "items": [
        {
          "exerciseId": "748576a4-3cf0-4f6e-b911-787cd149ef3f",
          "pushedAt": "2024-11-25T11:30:35.872994Z",
          "category": 1,
          "categoryShow": "個人練習",
          "title": "個人練習測試",
          "markMethod": 2,
          "markMethodShow": "手動",
          "status": 1
        }
      ]
    }
  ]
}

Assignment practice

分配個人練習

Request (AssignmentPracticeReq)

POST /web/practice

{
  "userId": "b84d022d-3280-4f61-aa85-2161ac417d29",
  "exerciseCategory": 1,
  "deadline": null,
  "markingMethod": null,
  "lessonId": null,
  "chapterId": null,
  "title": "個人練習測試",
  "subTitle": "subTitle",
  "content": "content",
  "type": 1,
  "fileKeys": [],
  "updatePicTotal": 0,
  "picRequired": false,
  "optionTotal": 2,
  "answerRequired": false,
  "answerTitle1": null,
  "answerTitle2": null,
  "answerTitle3": null,
  "answerTitle4": null,
  "answerTitle5": null,
  "option1": "kakaka",
  "option2": "hahaha",
  "option3": null,
  "option4": null,
  "option5": null,
  "option6": null,
  "option7": null,
  "option8": null,
  "option9": null,
  "option10": null,
  "option11": null,
  "minLabel": null,
  "maxLabel": null,
  "coin": 1,
  "experience": 10,
  "practiceCategory": 2,
  "loopType": 1,
  "loopEndTime": "2028-02-28T14:30:04.46335",
  "loopPractices": [
    {
      "times": 1,
      "startTime": "2028-02-14T12:30:00.00000",
      "deadline": "2028-02-15T23:59:59.00000"
    },
    {
      "times": 2,
      "startTime": "2028-02-15T12:30:00.00000",
      "deadline": "2028-02-16T23:59:59.00000"
    }
  ]
}

Response

{
  "success": true,
  "message": "",
  "data": null
}

---

Resources

AssignmentRecordPageFilterReq

properties

• userId

  String

  required

  用戶的ID

• statuses

  arrays[int]

  練習狀態過濾

• pagination

  pagination

  required

  分頁參數

• sortings

  sortings

  排序字段

AssignmentRecordPageResp

properties

• exerciseId

  String

  required

  練習的ID

• pushedAt

  datetime

  推送時間

• category

  int

  練習分類

• categoryShow

  string

  練習分類顯示

• title

  string

  標題

• markMethod

  int

  修改方法

• markMethodShow

  string

  修改方法顯示

• status

  int

  狀態

• pagination

  pagination

  required

  分頁參數

• sortings

  sortings

  排序字段

AssignmentPracticeReq

properties

• userId

  String

  required

  用戶的ID

• exerciseCategory

  int

  required

  練習分類

• deadline

  datetime

  截止日

• markingMethod

  int

  批改方法: 1:自動, 2:手動。category為學習建議時必填

• lessonId

  string

  課程ID。 category為學習建議時必填

• chapterId

  string

  章節ID。 category為學習建議時必填

• title

  string

  required

  練習標題

• subTitle

  string

  練習副標題，category為學習建議時不填

• content

  string

  required

  練習內容

• type

  int

  required

  練習題目類型

• fileKeys

  array[string]

  圖片fileKey列表，category為學習建議時不填

• updatePicTotal

  int

  上傳圖片數量，category為學習建議時不填

• picRequired

  boolean

  是否必須上傳圖片，category為學習建議時不填

• optionTotal

  int

  選項數量，category為學習建議時不填

• answerRequired

  string

  簡答是否必填，category為學習建議時不填

• answerTitle1

  string

  簡答標題1，category為學習建議時不填

• answerTitle2

  string

  簡答標題2，category為學習建議時不填

• answerTitle3

  string

  簡答標題3，category為學習建議時不填

• answerTitle4

  string

  簡答標題4，category為學習建議時不填

• answerTitle5

  string

  簡答標題5，category為學習建議時不填

• option1

  string

  選項1

• option2

  string

  選項2

• option3

  string

  選項3

• option4

  string

  選項4

• option5

  string

  選項5

• option6

  string

  選項6

• option7

  string

  選項7

• option8

  string

  選項8

• option9

  string

  選項9

• option10

  string

  選項10

• option11

  string

  選項11

• minLabel

  int

  最小標籤

• maxLabel

  int

  最大標籤

• coin

  int

  金幣

• experience

  string

  經驗

• practiceCategory

  PracticeCategory

  required

  練習頻率

• loopType

  LoopType

  練習模式

• loopEndTime

  datetime

  循環週期

• loopPractices

  object

  循環練習列表

• times

  int

  次數

• startTime

  datetime

  開始時間

• deadline

  datetime

  結束時間

PracticeCategory

Type	Description
1	單次
2	循環

LoopType

Type	Description
1	每日
2	每週
3	每月