---
# System prepended metadata

title: 科別管理

---

# 科別管理

## 科別列表

```url=
POST /division/list
```
Request
|  欄位 | 型態  | 必填 | 預設 | 說明  |
|---|---|---|---|---|
| pagination | json | | | 分頁 |
| - current | int | | 1 | 當前頁數 |
| - pageSize | int | | -2 | 每頁結果數量，-1 為顯示所有|
| sorter | json |  | | 排序欄位, 預設是用更新時間降序排列 |
| - field | string | | update_time | 排序欄位 |
| - order | string | | desc | 生序或降序


```javascript
{
    "query": {
        "name": "腎臟科",
        "status": "true"
    },
    "pagination": {
        "current": 1,
        "pageSize": 10
    },
    "sorter": {
        "field": "name",
        "order": "asc"
    }
}
```

Response
|  欄位 | 型態   | 說明  |
| -----| -----|-------- |
| name | string | 科別名稱 |
| status | boolean | 狀態 |
| updateTime | int | 最後更新時間 |

```json
{
  "httpCode": 200,
  "result": {
    "data": [
      {
        "name": "腎臟科",
        "status": true,
        "updateTime": 1609833413337
      }, 
      {
        "name": "新陳代謝科",
        "status": false,
        "updateTime": 1609833413337
      },
      {
        "name": "心臟科",
        "status": true,
        "updateTime": 1609833413337
      }
    ]
  }
}
```

## 新增科別

```url=
POST /division/add
```
Request
|  欄位 | 型態  | 必填 | 預設 | 說明  |
|---|---|---|---|---|
| name | string | * | | 科別名稱 |

```javascript
{
    "name": "腎臟科"
}
```

Response
|  欄位 | 型態   | 說明  |
| -----| -----|-------- |
| name | string | 科別名稱 |
| status | bool | 狀態 |

```json
{
  "httpCode": 200,
  "result": {
    "data": {
        "id": "4bfc740f-c0b1-4f1f-bff4-a1c4e6297ae3",
        "name": "心臟科2",
        "status": false,
        "createTime": 1609989027528,
        "updateTime": 1609989027528
    }
  }
}
```


## 編輯科別

```url=
POST /division/update
```
Request
|  欄位 | 型態  | 必填 | 預設 | 說明  |
|---|---|---|---|---|
| name | string | * | | 科別名稱 |

```javascript
{
    "id": "db72e3a9-18f3-4f1f-a6d6-7c3370799f49",
    "name": "腎臟科"
}
```

Response
|  欄位 | 型態   | 說明  |
| -----| -----|-------- |
| name | string | 科別名稱 |
| status | bool | 狀態 |

```json
{
  "httpCode": 200,
  "result": {
    "data": {
        "name": "腎臟科"
    }
  }
}
```

## 啟用停用科別

```url=
POST /division/status
```

Request
|  欄位 | 型態  | 必填 | 預設 | 說明  |
|---|---|---|---|---|
| activate | bool | * | | 啟用 |

```javascript
{
    "id": "db72e3a9-18f3-4f1f-a6d6-7c3370799f49",
    "activate": true
}
```

Response
|  欄位 | 型態   | 說明  |
| -----| -----|-------- |
| activate | bool | 啟用 |

```json
{
  "httpCode": 200,
  "result": {
    "data": {
        "id": "4bfc740f-c0b1-4f1f-bff4-a1c4e6297ae3",
        "name": "心臟科2",
        "status": true,
        "createTime": 1609989027528,
        "updateTime": 1609989027528
    }
  }
}
```