素材接口


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

素材列表

  • 接口描述:获取当前账号权限的素材列表。
  • 接口地址:/api/v1/biz/material/list?token=TOKEN&openId=OPEN_ID
  • 请求方式:GET
  • 传参方式:
  • 参数列表:
    参数名 是否必须 参数类型 说明
    bizType Int 2:企业素材 3:我的素材
    type Int 素材类型
    name String 素材名称
    tagIds String 标签Ids,例:id1,id2,id3
    startTime Long 开始时间戳(例:1639584000000)
    endTime Long 结束时间戳(例:1639584000000)
    pageNo Int 分页查询,默认第一页
    pageSize Int 分页查询,默认每页10条
  • 返回值:
    {
    "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-员工自定义标签
  • 返回值:
    {
    "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
  • 返回值:
    {
      "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
  • 返回值:

    {
    "success": true,
    "code": "200",
    "msg": null,
    "obj": null,
    "map": null,
    "list": null
    }
    

will 2024年6月4日 17:09 3629 收藏文档