# 平台管理員-帳號管理
[TOC]
## 租戶管理員帳號列表
```url
POST /account/platform-account/list
```
Request
| 欄位 | 型態 | 必填 | 說明 |
|---|---|---|---|
| query | json | | 查詢條件 |
| - status| bool | | 啟用狀態, true: 啟用, false: 停用, 未填則表示全部 |
| - name| string | | 關鍵字,查詢姓名或帳號, 組織名稱 |
| pagination | json | | 分頁 |
| - current | int | | 當前頁數 |
| - pageSize | int | | 每頁結果數量,預設為10|
| sorter | json | | 排序欄位, 預設是用更新時間降序排列 |
| - field | string | | 排序欄位, 預設為updateTime, 可排序欄位:name, account, status, updateTime |
| - order | string | | 升序或降序, 預設為desc|
```javascript
{
"query": {
"name": "",
"status": true
},
"pagination": {
"current": 1,
"pageSize": 10
},
"sorter": {
"field": "updateTime",
"order": "asc"
}
}
```
Response
| 欄位 | 型態 | 說明 |
|---|---|---|
| id | string | 帳號 id |
| name | string | 姓名 |
| account | string | 帳號名稱 |
| role | string | 系統內建角色, SYSTEM_ADMIN: 系統管理員, PLATFORM_ADMIN: 平台管理員, TENANT_ADMIN: 租戶管理員, TENANT_ROLE_USER: 租戶角色使用者 |
| telephone | string | 電話 |
| status | bool | 啟用狀態, true: 啟用, false: 停用 |
| updateTime | timestamp | 最後更新時間 |
| tenantId | string | 組織(租戶)id |
| tenantName | string | 組織(租戶)名稱 |
```javascript
{
"httpCode": 200,
"result": {
"data": [
{
"id": "594bcf8d-a134-4efd-9366-392b8194e631",
"name": "張三",
"account": "wei@yopmail.com",
"role": "TENANT_ADMIN",
"status": true,
"telephone": "0987000000",
"updateTime": 1610588709000,
"tenantId": "edf7f695-6d27-47c3-af9f-f57669bba45d",
"tenantName": "Osmile"
},
...
]
}
}
```
## 帳號組織(租戶)列表
```url
POST /account/tenant/list
```
Request
| 欄位 | 型態 | 必填 | 說明 |
|---|---|---|---|
| query | json | | 查詢條件 |
| 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 | 組織(租戶)名稱 |
| tenantType | string | 租戶類別, DEALER: 經銷單位, HOSPITAL:醫療機構, WMT:緯創醫學, BUSINESS:企業客戶 |
```javascript
{
"httpCode": 200,
"result": {
"data": [
{
"id": "594bcf8d-a134-4efd-9366-392b8194e631",
"name": "租戶_HOSPITAL_Test_1",
"tenantType": "HOSPITAL"
},
{
"id": "7a198963-e2aa-4937-92ad-c8bc9b4d7324",
"name": "企業客戶Test_1",
"tenantType": "BUSINESS"
},
...
]
}
}
```
## 新增租戶管理員帳號
```url
POST /account/platform-account/add
```
Request
| 欄位 | 型態 | 必填 | 說明 |
|---|---|---|---|
| name | string | Y | 姓名 |
| account | string | Y | 帳號, 格式為email |
| tenantId | string | Y | 租戶id |
| role | string | Y | 角色, 固定帶TENANT_ADMIN |
| telephone | string | | 電話 |
```javascript
{
"name": "張三",
"account": "aaa@abc.cc",
"tenantId": "7a198963-e2aa-4937-92ad-c8bc9b4d926c",
"role": "TENANT_ADMIN",
"telephone": "07-33345678"
}
```
Response
| 欄位 | 型態 | 說明 |
|---|---|---|
| id | string | 帳號 id |
| name | string | 姓名 |
| account | string | 帳號名稱 |
| role | string | 系統內建角色, SYSTEM_ADMIN: 系統管理員, PLATFORM_ADMIN: 平台管理員, TENANT_ADMIN: 租戶管理員, TENANT_ROLE_USER: 租戶角色使用者 |
| telephone | string | 電話 |
| status | bool | 啟用狀態, true: 啟用, false: 停用 |
| updateTime | timestamp | 最後更新時間 |
| tenantId | string | 組織(租戶)id |
| tenantName | string | 組織(租戶)名稱 |
```javascript
//httpCode: 200
{
"httpCode": 200,
"result": {
"data": {
"id": "594bcf8d-a134-4efd-9366-392b8194e631",
"name": "張三",
"account": "wei@yopmail.com",
"role": "TENANT_ADMIN",
"status": true,
"telephone": "0987000000",
"updateTime": 1610588709000,
"tenantId": "7a198963-e2aa-4937-92ad-c8bc9b4d926c",
"tenantName": "Osmile"
}
}
}
//httpCode: 422
{
"errorMsg": "SERVICE_ERROR.ACCOUNT_DUPLICATE",
"httpCode": 422
}
```
## 編輯租戶管理員帳號
```url
POST /account/platform-account/update
```
Request
| 欄位 | 型態 | 必填 | 說明 |
|---|---|---|---|
| id | string | Y | 帳號id |
| name | string | Y | 姓名 |
| telephone | string | | 電話 |
| status | bool | Y | 啟用狀態, true: 啟用, false: 停用 |
```javascript
{
"id": "594bcf8d-a134-4efd-9366-392b8194e631",
"name": "張三AA",
"telephone": "0987000000",
"status": true
}
```
Response
| 欄位 | 型態 | 說明 |
|---|---|---|
| id | string | 帳號 id |
| name | string | 姓名 |
| account | string | 帳號名稱 |
| role | string | 系統內建角色, SYSTEM_ADMIN: 系統管理員, PLATFORM_ADMIN: 平台管理員, TENANT_ADMIN: 租戶管理員, TENANT_ROLE_USER: 租戶角色使用者 |
| telephone | string | 電話 |
| status | bool | 啟用狀態, true: 啟用, false: 停用 |
| updateTime | timestamp | 最後更新時間 |
| tenantId | string | 組織(租戶)id |
| tenantName | string | 組織(租戶)名稱 |
```javascript
//httpCode: 200
{
"httpCode": 200,
"result": {
"data": {
"id": "594bcf8d-a134-4efd-9366-392b8194e631",
"name": "張三AA",
"account": "wei@yopmail.com",
"role": "TENANT_ADMIN",
"status": true,
"telephone": "0987000000",
"updateTime": 1610588709000,
"tenantId": "7a198963-e2aa-4937-92ad-c8bc9b4d926c",
"tenantName": "Osmile"
}
}
}
```
## 啟用停用租戶管理員帳號
```url
POST /account/platform-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 | 帳號名稱 |
| role | string | 系統內建角色, SYSTEM_ADMIN: 系統管理員, PLATFORM_ADMIN: 平台管理員, TENANT_ADMIN: 租戶管理員, TENANT_ROLE_USER: 租戶角色使用者 |
| telephone | string | 電話 |
| status | bool | 啟用狀態, true: 啟用, false: 停用 |
| updateTime | timestamp | 最後更新時間 |
| tenantId | string | 租戶id |
| tenantName | string | 租戶名稱 |
```javascript
{
"httpCode": 200,
"result": {
"data": {
"id": "594bcf8d-a134-4efd-9366-392b8194e631",
"name": "張三AA",
"account": "wei@yopmail.com",
"role": "TENANT_ADMIN",
"status": true,
"telephone": "0987000000",
"updateTime": 1610588709000,
"tenantId": "7a198963-e2aa-4937-92ad-c8bc9b4d926c",
"tenantName": "Osmile"
}
}
}
```