# 租戶管理員-帳號管理
[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
}
}
}
```