---
# System prepended metadata

title: 題目建立

---


參考 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",
        },
    ]
}
```