获取组合素材列表
最后更新:2025/03/11企业可通过此接口获取组合素材列表。
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/media/package/list?access_token=x
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"category_id": [
-1
],
"package_config_id": 580,
"tag_ids": [
123454523453534,
12343478954553534
],
"user_id": "admin",
"current_index": 1,
"page_size": 10
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
category_id | array | 否 | 分类id |
package_config_id | long | 是 | 组合素材类型id |
tag_ids | long[] | 否 | 素材标签id |
tag_uuids | str[] | 否 | 素材标签id(已弃用) |
user_id | string | 是 | 创建人id(三方应用下的员工userid),将根据此创建人来确定此组合素材的数据权限范围 |
use_status | int[] | 否 | 素材使用状态 0使用中 1停用 2未开始 3已过期 默认查询使用中的, 查询全部状态需传空集合 |
current_index | int | 否 | 页码。默认值为1 |
page_size | int | 否 | 列表返回长度。默认值为20,最大值为100 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"total": 1,
"records": [
{
"id": 307743,
"category_id": 0,
"category_pid": 0,
"type": 14,
"create_time": 1657876632,
"title": "1234",
"package_config_id": null,
"member_material_id_list": [
307236,
307666
],
"tag_id_list": [
"Xk0La/3n1+5WhclajfRztw==",
"dJOtBNzaoRy65dEqtx8/XB=="
],
"publish_status": 2,
"start_time": 1688203011,
"end_time": 1701422211,
"use_status": 0,
"risk_level": "R1",
"send_enabled": 1,
"browse_enabled": 1,
"visible_dept_ids": [
"dept_id1",
"dept_id2"
],
"visible_user_ids": [
"user_id1",
"user_id2"
]
}
]
}
}
返回说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 出错返回码,为0表示成功,非0表示调用失败 |
msg | string | 返回码描述 |
data | object | |
total | int | 总条数 |
records | array | 列表 |
id | long | 组合素材id |
category_id | long | 分类id |
category_pid | long | 父分类id |
type | long | 类型 |
create_time | long | 创建时间 |
title | string | 标题 |
package_config_id | long | 组合素材类型id |
member_material_id_list | long | 子素材id |
tag_id_list | array | 素材标签id |
publish_status | int | 0:长期有效 2:自定义有效时间 3:停用(默认长期有效) |
start_time | long | 有效开始时间,时间戳,格式:秒 |
end_time | long | 有效结束时间,时间戳,格式:秒 |
use_status | int | 素材使用状态 0使用中 1已停用 2未开始 3已过期 |
risk_level | string | 素材风险等级: R1-低风险 R2-中低风险 R3-中风险 R4-中高风险 R5-高风险 此字段仅金融版适用,非金融版请忽略此字段。 |
send_enabled | int | 在员工发送时是否需启用风险适当性匹配,0-不启用,1-启用 此字段仅金融版适用,非金融版请忽略此字段。 |
browse_enabled | int | 在客户浏览素材时是否需启用风险适当性匹配,0-不启用,1-启用 此字段仅金融版适用,非金融版请忽略此字段。 |
visible_dept_ids | string[] | 组合素材可见范围部门ID列表.若返回的员工id和部门id都为空,则默认为此组合素材原创建人所负责的管理组对应的同组和上级管理员、管理范围内成员可见。 |
visible_user_ids | string[] | 组合素材可见范围员工ID(三方应用下的userid)列表.若返回的员工id和部门id都为空,则默认为此组合素材原创建人所负责的管理组对应的同组和上级管理员、管理范围内成员可见。 |