Skip to content

获取素材列表

拥有此API的权限集
素材管理-查询

请求方式及url

  • 请求方式:POST
  • 请求头:Content-Type:application/json
  • 接口地址:https://api.xiaoe-tech.com/xe.material.list/1.0.0
  • 频率限制: 10秒3000次

接口调试

请求参数
响应结果
暂无响应数据

请求参数

参数名必选类型说明
access_tokenstring专属token
typeint素材类型 1-图片 2-音频 3-视频 4-电子书 5-文档
sort_keywordint排序字段,默认为0; 0-主键id,1-material_size-文件大小,3-refer_count-被引用数,4-view_count-访问数,5-title-标题
sort_orderint排序顺序,默认为1; 1-ASC顺序 2-DESC倒序
titlestring查询素材名称
cur_pageint当前页码 默认为1
page_sizeint分页大小 默认10 最大不能超过100
upload_start_atstring上传日期起始点
upload_end_atstring上传日期截止点

请求示例

{
    "access_token":"xe_xxxxx",
    "type":1,
    "cur_page":1,
    "page_size":10
}

返回参数

参数名类型说明
codeint返回码
msgstring返回信息
dataobject返回值

data返回值

参数名类型说明
itemsarray素材数据
cur_pageint当前页码
page_sizeint分页大小
totalint总数据量

items素材数据

参数名类型说明
app_idstring店铺id
titlestring素材名称
typeint素材类型 1-图片 2-音频 3-视频 4-电子书 5-文档
category_idint分组id
material_idstring素材id
material_sizedouble素材大小(KB)
material_propertyobject素材属性,类型为电子书或文档时,无相关属性
refer_countint素材引用数

material_property素材属性

参数名类型说明
widthint宽px
heightint高px
lengthdouble文件类型为音频时,音频时长(s),文件类型为视频时,视频时长(s)
patch_img_urlstring封面贴图
pixel_datastring分辨率 如"464*640"

返回示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "cur_page": 1,
        "items": [
            {
                "app_id": "appxxxx",
                "category_id": 7,
                "material_id": "1edd48a3-df2f-4791-bb58-be68f5b66bae",
                "material_property": null,
                "material_size": "126.49",
                "refer_count": 1,
                "title": "突突突_详情.jpeg",
                "type": 1
            }
        ],
        "page_size": 10,
        "total": 13299
    }
}