參考 API 通用格式 : [連結](/XL6s3RkpRJexXJ3vFmqHlA) ## 1️⃣ 介紹 ### 資料影響範圍 > R-讀取 O-輸出(產生成文件) W-寫入 ``` subject (R/W) 題目資料庫 ``` ### 功能說明 建立簡單的題庫系統,只展示客戶想看的,簡單的就不做了 類型目前有 1:選擇題 2:填空題 3:完型填空 4:組合題 ## 2️⃣ 請求說明 Request ### Header 欄位 | 項目 | 說明 | |----|----| | URL | /tabf/subject | | method | post | ### Request Body 欄位 | 欄位 | 名稱 | 資料型別 | 必填 | 資料儲存 & 說明 | |----|----|------|----|-----------| | type | 題目類型 | string | Y | 1:選擇題 2:填空題 3:完型填空 4:組合題 | | questionId | 題目代號 | string | Y,N | 有丟是新增沒丟是編輯 | | content | 題目內容 |string| N | | difficulty | 難度 |string| N | "低"、"中"、"高" | analyse | 題目解析 | string | N | | | answers | 答案 |ArrayObject | N | ### Answers child node | 欄位 | 名稱 | 資料型別 | 必填 | 資料儲存 & 說明 | |----|----|------|----|-----------| | index | 順序 | int | Y | | group | 群組 | int | | content | 答案內容 | ArrayString | 無論答案是否有同義詞,統一都是送字串陣列,僅能送一組的就送第一組來即可。後端依照題目類型去決定要抓幾組存檔 | isAnswer | 是否是答案 | string | | knowledge | 知識點 | string | ## 3️⃣ 業務說明 ### 流程 ## 4️⃣ 回應說明 Response | 欄位 | 名稱 | 資料型別 | 資料儲存 & 說明 | | ----- | -------------- | -------- | --------------- | | questionId | 題目ID |string | 為了緩存而設計的...有可能編輯的途中一直無腦存檔 ### Response 範例 ```json { "syscode": "0000", "message": "Success.", "success": true, "total": 3, "data": [ { "questionId":"ba3e713f-1b38-4d94-8e4b-214ea8edca9a", }, ] } ```