# 欣智外部串接API文件

## 取得部門列表(走平台驗證)

#### Request
* **URL** : ```/api/csweb/department```
* **URL parameters** :
| KEY | TYPE | DESCRIPTION |
| --- | --- | --- |
| at_prev | int | 指定上層部門編號，取得子部門列表 (選填) <br> -1 : 所有部門 (預設) |
| is_enable | int | 篩選部門啟用狀態 (選填) <br> -1 : 所有狀態 (預設) <br> 0 : 停用 <br> 1 : 啟用 |
| ao_sid | int |組織編號 <BR> 預設為0 |
* **Body** :
N/A

#### Response
* **Body** :
| KEY | TYPE | DESCRIPTION |
| --- | --- | --- |
| data | object[] | 部門列表 |
| result | bool | API執行結果 <br> true : 成功 <br> false : 失敗 |
| code | int | 錯誤碼 <br> 0 : 成功 <br> 1 : 有必填的API參數沒給 <br> 2 : API執行失敗 |
| errmsg | string | 錯誤訊息 |

* **data parameters**
| KEY | TYPE | DESCRIPTION |
| --- | --- | --- |
| at_sid | int | 部門編號 |
| at_prev | int | 上層部門編號 |
| at_name | string | 部門名稱 |
| is_enable | bool | 部門是否啟用 <br> true : 啟用 <br> false : 停用 |

## 更新特定人員外部系統權限(需走平台驗證)

#### Request

* **URL** : `/api/csweb/ext/permission`
* **URL parameters** :
N/A

* **Body** :
| KEY | TYPE | DESCRIPTION |
| --- | --- | --- |
| member_list | object[] | 批次更新人員列表 |
| replace | bool | 以取代或指定的方式更新權限<BR> false:以指定的方式更新權限<BR> true:以取代的方式更新權限 |
| is_add | bool | 在指定的方式下，以累加或移除的方式處理權限<BR> false:以移除的方式更新權限<BR> true:以累加的方式更新權限

* **Member_list**:
| KEY | TYPE | DESCRIPTION |
| --- | --- | --- |
| aa_sid | int | 人員編號 |
| perm_enum | int[] | 檔案目錄權限列舉列表<BR> 重要事件通報平台:Event = 1<BR> 訊息通報平台: Message = 2 <BR>矯正E化平台:EPF = 4|

#### Response

* **Body** :

| KEY | TYPE | DESCRIPTION |
| --- | --- | --- |
| result | bool | API執行結果 <br>true : 成功 <br>false : 失敗 |
| code | int | 錯誤碼 <br>0 : 成功 <br>1 : 有必填的API參數沒給 <br>2 : API執行失敗 |
| errmsg | string | 錯誤訊息 |