---
# System prepended metadata

title: 租戶管理員-帳號管理

---

# 租戶管理員-帳號管理

[TOC]

## 租戶角色使用者帳號列表

```url
POST /account/tenant-account/list
```
Request
| 欄位 | 型態 | 必填 | 說明 |
|---|---|---|---|
| query | json | | 查詢條件 |
| - status | bool | | 啟用狀態, true: 啟用, false: 停用, 未填則表示全部 |
| - name | string | | 關鍵字,查詢姓名或帳號, 身份證字號 |
| - tenantRoleId | string | | 租戶角色id |
| - divisionId | string | | 服務科別id |
| pagination | json | | 分頁 |
| - current | int | | 當前頁數 |
| - pageSize | int | | 每頁結果數量，預設為10|
| sorter | json | | 排序欄位, 預設是用更新時間降序排列 |
| - field | string | | 排序欄位, 預設為updateTime, 可排序欄位:name, account, status, updateTime |
| - order | string | | 升序或降序, 預設為desc|

```javascript
{
  "query": {
      "name": "",
      "status": true,
      "tenantRoleId": "",
      "divisionId": ""
  },
  "pagination": {
      "current": 1,
      "pageSize": 10
  },
  "sorter": {
      "field": "updateTime",
      "order": "asc"
  }
}
```

Response
| 欄位 | 型態 | 說明 |
|---|---|---|
| id | string | 帳號 id |
| name | string | 姓名 |
| account | string | 帳號名稱 |
| idNo | string | 身份證字號 |
| tenantRoleId | string | 租戶角色id |
| tenantRoleName | string | 租戶角色名稱 |
| divisionId | string | 服務科別id |
| divisionName | string | 服務科別名稱 |
| telephone | string | 電話 |
| status | bool | 啟用狀態, true: 啟用, false: 停用 |
| updateTime | timestamp | 最後更新時間 |

```javascript
{
  "httpCode": 200,
  "result": {
    "data": [
      {
        "id": "594bcf8d-a134-4efd-9366-392b8194e631",
        "name": "張三",
        "account": "wei@yopmail.com",
        "tenantRoleId": "5253249c-edd1-4bd0-b63a-3826beb9b9b2", 
        "tenantRoleName": "心臟科醫師"
        "divisionId": "c09ca6f0-cef2-4348-bac4-018b6d3664da", 
        "divisionName": "心臟科",
        "status": true,
        "telephone": "0987000000",
        "updateTime": 1610588709000
      }, 
      ...
    ]
  }
}
```

## 租戶角色列表

```url
POST /account/tenant-role/list
```
Request
| 欄位 | 型態 | 必填 | 說明 |
|---|---|---|---|
| query | json | | 查詢條件 |
|  - tenantId | string | Y | 租戶id, 若沒帶值,預設使用token裡的tenantId |
| pagination | json | | 分頁 |
| - current | int | | 當前頁數 |
| - pageSize | int | | 每頁結果數量，預設為10|
| sorter | json | | 排序欄位, 預設是用更新時間降序排列 |
| - field | string | | 排序欄位 |
| - order | string | | 升序或降序, 預設為desc|

```javascript
{
  "query": {
  },
  "pagination": {
      "current": 1,
      "pageSize": 10
  },
  "sorter": {
  }
}
```

Response
| 欄位 | 型態 | 說明 |
|---|---|---|
| id | string | 租戶角色id |
| name | string | 租戶角色名稱 |

```javascript
{
  "httpCode": 200,
  "result": {
    "data": [
      {
        "id": "5253249c-edd1-4bd0-b63a-3826beb9b9b2",
        "name": "心臟科醫師"
      }, 
      {
        "id": "8a439c5b-077c-4735-81b0-d3007490111b",
        "name": "腎臟科個管師",
      }, 
      ...
    ]
  }
}
```

## 租戶服務科別列表

```url
POST /account/tenant-division/list
```
Request
| 欄位 | 型態 | 必填 | 說明 |
|---|---|---|---|
| query | json | | 查詢條件 |
|  - tenantId | string | Y | 租戶id, 若沒帶值,預設使用token裡的tenantId |
| pagination | json | | 分頁 |
| - current | int | | 當前頁數 |
| - pageSize | int | | 每頁結果數量，預設為10|
| sorter | json | | 排序欄位, 預設是用更新時間降序排列 |
| - field | string | | 排序欄位 |
| - order | string | | 升序或降序, 預設為desc|

```javascript
{
  "query": {
  },
  "pagination": {
      "current": 1,
      "pageSize": 10
  },
  "sorter": {
  }
}
```

Response
| 欄位 | 型態 | 說明 |
|---|---|---|
| id | string | 科別id |
| name | string | 科別名稱 |

```javascript
{
  "httpCode": 200,
  "result": {
    "data": [
      {
        "id": "5253249c-edd1-4bd0-b63a-3826beb9b9b2",
        "name": "心臟科"
      }, 
      {
        "id": "8a439c5b-077c-4735-81b0-d3007490111b",
        "name": "腎臟科",
      }, 
      ...
    ]
  }
}
```


## 新增租戶角色使用者帳號

```url
POST /account/tenant-account/add
```
Request
| 欄位 | 型態 | 必填 | 說明 |
|---|---|---|---|
| name | string | Y | 姓名 |
| account | string | Y | 帳號, 格式為email |
| idNo | string | | 身份證字號 |
| tenantRoleId | string | Y | 租戶角色id |
| divisionId | string | Y | 服務科別id |
| telephone | string | | 電話 |


```javascript
{
    "name": "張三",
    "account": "aaa@abc.cc",
    "idNo": "",
    "tenantRoleId": "5253249c-edd1-4bd0-b63a-3826beb9b9b2",
    "divisionId": "4bfc740f-c0b1-4f1f-bff4-a1c4e6297ae3",
    "telephone": "07-33345678"
}
```

Response
| 欄位 | 型態 | 說明 |
|---|---|---|
| id | string | 帳號 id |
| name | string | 姓名 |
| account | string | 帳號名稱 |
| idNo | string | 身份證字號 |
| tenantRoleId | string | 租戶角色id |
| tenantRoleName | string | 租戶角色名稱 |
| divisionId | string | 服務科別id |
| divisionName | string | 服務科別名稱 |
| telephone | string | 電話 |
| status | bool | 啟用狀態, true: 啟用, false: 停用 |
| updateTime | timestamp | 最後更新時間 |

```javascript
//httpCode: 200
{
  "httpCode": 200,
  "result": {
    "data": {
        "id": "594bcf8d-a134-4efd-9366-392b8194e631",
        "name": "張三",
        "account": "wei@yopmail.com",
        "tenantRoleId": "5253249c-edd1-4bd0-b63a-3826beb9b9b2", 
        "tenantRoleName": "心臟科醫師"
        "divisionId": "c09ca6f0-cef2-4348-bac4-018b6d3664da", 
        "divisionName": "心臟科",
        "status": true,
        "telephone": "0987000000",
        "updateTime": 1610588709000
    }
  }
}

//httpCode: 422
{
    "errorMsg": "SERVICE_ERROR.ACCOUNT_DUPLICATE",
    "httpCode": 422
}
```

## 編輯租戶角色使用者帳號

```url
POST /account/tenant-account/update
```
Request
| 欄位 | 型態 | 必填 | 說明 |
|---|---|---|---|
| id | string | 帳號 id |
| name | string | 姓名 |
| account | string | 帳號名稱 |
| idNo | string | 身份證字號 |
| tenantRoleId | string | 租戶角色id |
| tenantRoleName | string | 租戶角色名稱 |
| divisionId | string | 服務科別id |
| divisionName | string | 服務科別名稱 |
| telephone | string | 電話 |
| status | bool | 啟用狀態, true: 啟用, false: 停用 |
| updateTime | timestamp | 最後更新時間 |

```javascript
{
    "id": "594bcf8d-a134-4efd-9366-392b8194e631",
    "name": "張三AA",
    "telephone": "0987000000",
    "tenantRoleId": "5253249c-edd1-4bd0-b63a-3826beb9b9b2",
    "divisionId": "c09ca6f0-cef2-4348-bac4-018b6d3664da", 
    "status": true
}
```

Response
| 欄位 | 型態 | 說明 |
|---|---|---|
| id | string | 帳號 id |
| name | string | 姓名 |
| account | string | 帳號名稱 |
| idNo | string | 身份證字號 |
| tenantRoleId | string | 租戶角色id |
| tenantRoleName | string | 租戶角色名稱 |
| divisionId | string | 服務科別id |
| divisionName | string | 服務科別名稱 |
| telephone | string | 電話 |
| status | bool | 啟用狀態, true: 啟用, false: 停用 |
| updateTime | timestamp | 最後更新時間 |

```javascript
//httpCode: 200
{
  "httpCode": 200,
  "result": {
    "data": {
        "id": "594bcf8d-a134-4efd-9366-392b8194e631",
        "name": "張三",
        "account": "wei@yopmail.com",
        "tenantRoleId": "5253249c-edd1-4bd0-b63a-3826beb9b9b2", 
        "tenantRoleName": "心臟科醫師"
        "divisionId": "c09ca6f0-cef2-4348-bac4-018b6d3664da", 
        "divisionName": "心臟科",
        "status": true,
        "telephone": "0987000000",
        "updateTime": 1610588709000
    }
  }
}

```

## 啟用停用租戶角色使用者帳號

```url
POST /account/tenant-account/status
```
Request
| 欄位 | 型態 | 必填 | 說明 |
|---|---|---|---|
| id | string | Y | 租戶id |
| status | bool | Y | 啟用狀態, true: 啟用, false: 停用 |


```javascript
{
    "id": "594bcf8d-a134-4efd-9366-392b8194e631",
    "status": true
}
```

Response
| 欄位 | 型態 | 說明 |
|---|---|---|
| id | string | 帳號 id |
| name | string | 姓名 |
| account | string | 帳號名稱 |
| idNo | string | 身份證字號 |
| tenantRoleId | string | 租戶角色id |
| tenantRoleName | string | 租戶角色名稱 |
| divisionId | string | 服務科別id |
| divisionName | string | 服務科別名稱 |
| telephone | string | 電話 |
| status | bool | 啟用狀態, true: 啟用, false: 停用 |
| updateTime | timestamp | 最後更新時間 |

```javascript
{
  "httpCode": 200,
  "result": {
    "data": {
        "id": "594bcf8d-a134-4efd-9366-392b8194e631",
        "name": "張三",
        "account": "wei@yopmail.com",
        "tenantRoleId": "5253249c-edd1-4bd0-b63a-3826beb9b9b2", 
        "tenantRoleName": "心臟科醫師"
        "divisionId": "c09ca6f0-cef2-4348-bac4-018b6d3664da", 
        "divisionName": "心臟科",
        "status": true,
        "telephone": "0987000000",
        "updateTime": 1610588709000
    }
  }
}

```
