IR 子帳號功能 API 文件
=========

<!-- We don't need Create & Delete API, sub_user was created automatically when you create sub-account in ISHA. -->

## API

- [GET] 'sub-accounts/'                  獲取所有子帳號
- [POST] 'sub-accounts/update/{id}'      更新一個子帳號
- [GET] 'ir-roles'                       獲取所有職務 (根據登入的廠商)
- [POST] 'ir-roles'                      新增一個職務
- [POST] 'ir-roles/update/{id}'          更新一個職務
- [POST] 'ir-roles/destroy/{id}'         刪除一個職務
- [GET] 'ir-permissions/'                獲取所有權限

## GET (獲取所有子帳號)

### Response

```
[
    {
        "id": 11,
        "account": "[同 ISHA 的帳號]",
        "name": "",
        "phone" "",
        "role": "",
    },
    {
        id: 14,
        "account": "",
        "name": "",
        "phone": "",
        "role": "",
    }
]
```

## POST UPDATE (更新子帳號，只會更新「職務」)

### Body

```
{
    role: 13,
}
```

## GET READ (獲取所有職務)

### Response

```
[
    {
        "id": 11,
        "role_name": "審核員",
        "subuser_id": 2,
        "permissions": [
            {
                id: 1,
                "name": "",
                "name_zh": "",
            },
        ],
    },
    {
        "id": 11,
        "role_name": "查核員",
        "subuser_id": 2,
        "permissions": [
            {
                id: 1,
                "name": "",
                "name_zh": "",
            },
        ],
    }
]
```

## POST (新增一個職務)

### Body

```
{
    "role_name": "[new role name]",
    "permissions": [
        1, 2, 4
    ],
}
```
- need to append subuser_id in backend

### Response
```
{
    "id": 11,
    "role_name": "查核員",
    "subuser_id": 2,
    "permissions": [
        {
            id: 1,
            "name": "",
            "name_zh": "",
        },
    ],
}
```


## POST (更新一個職務)

### Body

```
{
    role_name: "[new role name]",
    permissions: [
        4, 7, 8,
    ],
}
```
- need to append subuser_id in backend

## GET (獲取所有權限)

### Response

```
[
    {
        id: 1,
        name: "section_r",
        name_zh: "讀取單位",
    },
    ...
]
```