---
# System prepended metadata

title: 系統管理員-帳號管理
tags: [KIS]

---

# 系統管理員-帳號管理

[TOC]

## 平台管理員帳號列表

```url
POST /account/system-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": "PLATFORM_ADMIN", 
        "status": true,
        "telephone": "0987000000",
        "updateTime": 1610588709000,
        "tenantId": "WMT",
        "tenantName": "緯創醫學"
      }, 
      ...
    ]
  }
}
```

## 帳號組織(租戶)列表

```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 | 組織(租戶)名稱 |

```javascript
{
  "httpCode": 200,
  "result": {
    "data": [
      {
        "id": "594bcf8d-a134-4efd-9366-392b8194e631",
        "name": "租戶_HOSPITAL_Test_1"
      }, 
      {
        "id": "7a198963-e2aa-4937-92ad-c8bc9b4d926c",
        "name": "租戶Test_HOSPITAL",
      }, 
      ...
    ]
  }
}
```

## 新增平台管理員帳號

```url
POST /account/system-account/add
```
Request
| 欄位 | 型態 | 必填 | 說明 |
|---|---|---|---|
| name | string | Y | 姓名 |
| account | string | Y | 帳號, 格式為email |
| tenantId | string | Y | 租戶id, 固定帶WMT, 表示緯創醫學 |
| role | string | Y | 角色, 固定帶PLATFORM_ADMIN |
| telephone | string | | 電話 |


```javascript
{
    "name": "張三",
    "account": "aaa@abc.cc",
    "tenantId": "WMT",
    "role": "PLATFORM_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": "PLATFORM_ADMIN", 
            "status": true,
            "telephone": "0987000000",
            "updateTime": 1610588709000,
            "tenantId": "WMT",
            "tenantName": "緯創醫學"
        }
    }
}

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

## 編輯平台管理員帳號

```url
POST /account/system-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": "PLATFORM_ADMIN", 
            "status": true,
            "telephone": "0987000000",
            "updateTime": 1610588709000,
            "tenantId": "WMT",
            "tenantName": "緯創醫學"
        }
    }
}

```

## 啟用停用平台管理員帳號

```url
POST /account/system-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": "PLATFORM_ADMIN", 
            "status": true,
            "telephone": "0987000000",
            "updateTime": 1610588709000,
            "tenantId": "WMT",
            "tenantName": "緯創醫學"
        }
    }
}

```

## 修改userProfile
```url
POST /user/profile/update
```
Request:

Attribute | Type | IsRequired | Remark
-|-|-|-
idNo   | String | Y | 身分證字號
birthDate | String | Y | 生日(yyyy-MM-dd)
name | String | Y | 姓名
telephone | String | Y | 電話
bodyHeight | number | Y | 身高
gender | int | Y | 性別 1:男性/2:女性
address | String | Y | 地址
bloodType | String | N | 血型(O/AB/A/B)
email | String | N | email

```javascript
{
	"bodyHeight": 175.5,
	"name": "更新個人1",
	"birthDate": "2021-02-17",
	"telephone": "09123456789",
	"email": "test@gmail.com",
	"gender": 1,
	"address": "高雄市鹽埕區大勇路98號",
	"bloodType": "A"
}
```

Response: 

```javascript
{
    "httpCode": 200,
    "result": {
        "data": {
            "id": "18c45773-af33-4ae4-a129-9618703032fc",
            "account": "C188256154",
            "accountType": "APP",
            "name": "更新個人1",
            "role": "GENERAL_PUBLIC",
            "idNo": "C188256154",
            "telephone": "09123456789",
            "email": "test@gmail.com",
            "status": false,
            "isFirstLogin": true,
            "createTime": 1614230493000,
            "updateTime": 1614256990000
        }
    }
}
```
###### tags: `KIS`