素材接口

> 通过本章节提供对素材标签进行管理及素材与标签的绑定能力接口

## 素材列表

- **接口描述：**获取当前账号权限的素材列表。
- **接口地址：**`/api/v1/biz/material/list?token=TOKEN&openId=OPEN_ID`
- **请求方式：**`GET`
- **传参方式：**
- **参数列表：**
| **参数名** | **是否必须** | **参数类型** | **说明** |
| --- | --- | --- | --- |
| bizType | 是 | Int | 2：企业素材  3：我的素材  |
| type | 是 | Int | [素材类型](https://hc.eqxiu.cn/doc/18/)|
| name | 否 | String | 素材名称 |
| tagIds | 否 | String | 标签Ids，例：id1,id2,id3 |
| startTime | 否 | Long | 开始时间戳（例：1639584000000） |
| endTime | 否 | Long | 结束时间戳（例：1639584000000） |
| pageNo | 否 | Int | 分页查询，默认第一页 |
| pageSize | 否 | Int | 分页查询，默认每页10条 |

- **返回值：**
```json
{
  "success": true,
  "code": "200",
  "msg": null,
  "obj": null,
  "map": {
    "pageNo": 1,
    "count": 1,
    "pageSize": 20,
    "end": true
  },
  "list": [
     {
      "id": 2502,
      "name": "src=http___img.gr512.com_KESchoolImage_64_jpg_20180913214331_3221.jpg&refer=http___img.gr512.jpg",
      "bizType": 3,
      "type": 1,
      "corpId": "6b0efe8c048d40d3bfa293f015d4369b",
      "uploadType": 0,
      "path": "1e5a65a5fa614848bbdd32bc7d3ef2af/795c25c6a38a499280bd9b55306b022a",
      "tmbPath": "1e5a65a5fa614848bbdd32bc7d3ef2af/795c25c6a38a499280bd9b55306b022a",
      "height": null,
      "width": null,
      "size": 30,
      "durationTime": 0,
      "keywords": null,
      "status": 1,
      "createUser": "管理员",
      "createTime": "2022-01-25 14:45:00",
      "updateUser": null,
      "updateTime": "2022-01-25 14:45:00",
      "content": null,
      "tagId": null,
      "transcodePath": null,
      "coverPath": null
    }
  ]
}
```
- **返回值说明：**
| **参数** | **参数类型** | **说明** |
| --- | --- | --- |
| id |  |  |
| name |  |  |
| bizType |  |  |
| type |  |  |
| corpId |  |  |
| uploadType |  |  |
| path |  |  |
| tmbPath |  |  |
| height |  |  |
| width |  |  |
| size |  |  |
| durationTime |  |  |
| keywords |  |  |
| status |  |  |
| createUser |  |  |
| createTime |  |  |
| updateUser |  |  |
| updateTime |  |  |
| content |  |  |
| tagId |  |  |
| transcodePath |  |  |
| coverPath |  |  |

## 素材标签列表

- **接口描述：**获取素材标签列表。
- **接口地址：**`/api/v1/base/tag/list?token=TOKEN`
- **请求方式：**`GET`
- **传参方式：**
- **参数列表：**
| **参数名** | **是否必须** | **参数类型** | **说明** |
| --- | --- | --- | --- |
| pId | 是 | Long | 317：图片素材，318：音频素材，271：视频素材 |
| querySubTag | 是 | Boolean | 是否查询下级标签 |
| bizType | 是 | Integer | 标签类型：2-企业自定义标签、3-员工自定义标签 |

- **返回值：**
```json
{
  "success": true,
  "code": "200",
  "msg": null,
  "obj": null,
  "map": null,
  "list": [
    {
      "id": 100038,
      "title": "东方闪电",
      "parentId": 317,
      "sort": 0,
      "status": 1,
      "children": null,
      "bizCode": null,
      "relId": "9a1a23cb67f44583af968c989a735089",
      "name": "东方闪电",
      "type": 3
    }
  ]
}
```
- **返回值：**
| **参数** | **参数类型** | **说明** |
| --- | --- | --- |
| id | Long | 标签id |
| title | String | 标签名称 |
| parentId |  |  |
| sort |  |  |
| status |  |  |
| children |  |  |
| bizCode |  |  |
| relId |  |  |
| name |  |  |
| type |  |  |

## 新增素材标签

- **接口描述：**增加一个企业素材标签。
- **接口地址：**`/api/v1/base/tag/add?token=TOKEN`
- **请求方式：**`POST`
- **传参方式：**URL显式参数
- **参数列表：**
| **参数名** | **是否必须** | **参数类型** | **说明** |
| --- | --- | --- | --- |
| pId | 是 | Long | 317：图片素材，318：音频素材，271：视频素材 |
| title | 是 | String | 标签名称（不超过50个字符） |
| bizType | 是 | Integer | 标签类型：2-企业自定义标签、3-员工自定义标签 |
| bizCode | 是 | String | tag_corp-企业素材tag |

- **返回值：**
```json
{
    "success": true,
    "code": "200",
    "msg": null,
    "obj": null,
    "map": null,
    "list": null
}
```

## 素材绑定标签

- **接口描述：**素材绑定标签。
- **接口地址：**`/api/v1/biz/material/tag/update/batch?token=TOKEN`
- **请求方式：**`POST`
- **传参方式：**URL显式参数
- **参数列表：**
| **参数名** | **是否必须** | **参数类型** | **说明** |
| --- | --- | --- | --- |
| tagIds | 是 | String | 标签id  例：100617,100618 |
| materialIds | 是 | String | 素材id  例：2829,2828 |

- **返回值：**
```json
{
  "success": true,
  "code": "200",
  "msg": null,
  "obj": null,
  "map": null,
  "list": null
}
```