---
# System prepended metadata

title: 欣智外部串接API文件

---

# 欣智外部串接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 | 錯誤訊息 |
    
    
    
