# 平台管理員-帳號管理 [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" } } } ```