获取素材列表
最后更新:2024/08/12企业可通过此接口素材列表。
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/media/list?access_token=x
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"category_id": [
1,
2
],
"type": 2,
"keyword": "",
"private_flag": true,
"user_id": "Wang",
"filter": "create",
"current_index": 1,
"page_size": 10,
"material_id": 414354,
"use_status": [0],
"filter_material_ids": [154896234232343, 153424225786385]
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
category_id | long[] | 否 | 素材分类id |
type | int | 是 | 素材类型 1:海报,2:文本,3:图片,4:文章,6:视频,7:文件,8:小程序,9:网页 |
keyword | string | 否 | 搜索关键字 |
private_flag | bool | 否 | 是否是我的素材 |
user_id | string | 否 | 用户id |
filter | string | 否 | create:创建 favorite:收藏 默认/all:全部(当private_flag为true时,需传入参数“create”或者“favorite”) |
current_index | int | 否 | 页码。默认值为1 |
page_size | int | 否 | 列表返回长度。默认值为20,最大值为100 |
material_id | long | 否 | 素材id(当入参条件包含素材id时,接口调用链路走新的接口调用) |
use_status | int[] | 否 | 素材使用状态 0使用中 1停用 2未开始 3已过期 默认查询使用中的, 查询全部状态需传空集合 |
filter_material_ids | long[] | 否 | 查询的素材ids |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"total": 29,
"records": [
{
"id": 23399,
"category_id": 709,
"category_pid": 633,
"type": 2,
"creator": "Wang",
"create_time": 1634614328,
"publish_status": 2,
"start_time": 1688203011,
"end_time": 1701422211,
"use_status": 0,
...
}
]
}
}
返回说明: 所有素材类型都包含公共字段,根据素材类型不同返回素材类型特有参数。
公共字段:
参数 | 类型 | 说明 |
---|---|---|
code | int | 出错返回码,为0表示成功,非0表示调用失败 |
msg | string | 返回码描述 |
data | Page | 分页对象 |
total | int | 总条数 |
records | Media[] | 数据列表 |
id | long | 素材id |
category_id | long | 分类id |
category_pid | long | 分类父级id |
type | int | 素材类型 |
creator | string | 创建人id |
create_time | long | 创建时间 |
publish_status | int | 0:长期有效 2:自定义有效时间 3:停用(默认长期有效) |
start_time | long | 有效开始时间,时间戳,格式:秒 |
end_time | long | 有效结束时间,时间戳,格式:秒 |
use_status | int | 使用状态 0使用中 1已停用 2未开始 3已过期 |
各素材类型说明:
海报:
参数 | 类型 | 说明 |
---|---|---|
title | string | 标题 |
snapshot_url | string | 海报快照url |
thumbnail_url | string | 海报缩略图url |
initial_download | int | 初始下载量 |
poster_type | int | 海报类型 |
文本素材:
参数 | 类型 | 说明 |
---|---|---|
plain_text | string | 文本内容 |
title | string | 标题 |
图片素材:
参数 | 类型 | 说明 |
---|---|---|
title | string | 图片标题 |
img_url | string | 图片地址 |
file_id | long | 图片文件id |
文章素材:
参数 | 类型 | 说明 |
---|---|---|
title | string | 标题 |
abstract_info | string | 摘要信息 |
image_base | string | 封面图文件id |
image_base_url | string | 封面图文件url |
web_type | Integer | 文章类型(1:自定义文章) |
web_url | string | 文章地址 |
视频素材:
参数 | 类型 | 说明 |
---|---|---|
image_base | string | 封面图文件id |
image_base_url | string | 封面图文件url |
file_id | string | 视频文件id |
file_name | string | 视频文件名称 |
file_url | string | 视频文件地址 |
title | string | 视频标题 |
abstract_info | string | 视频摘要 |
文件素材:
参数 | 类型 | 说明 |
---|---|---|
file_id | string | 文件id |
file_url | string | 文件地址 |
file_extension | string | 文件后缀 |
file_name | string | 文件名 |
file_size | long | 文件大小(byte) |
title | string | 文件标题 |
小程序素材:
参数 | 类型 | 说明 |
---|---|---|
title | string | 标题 |
image_base | string | 封面图文件id |
image_base_url | string | 封面图文件地址 |
app_id | string | 小程序id |
app_path | string | 小程序路径 |
外部链接:
参数 | 类型 | 说明 |
---|---|---|
title | string | 标题 |
abstract_info | string | 摘要信息 |
image_base | string | 封面图文件id |
image_base_url | string | 封面图文件url |
origin_link | string | 连接地址 |
short_link | string | 短连接地址 |