获取素材列表

最后更新: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 短连接地址

results matching ""

    No results matching ""