# 获取素材标签列表

请求方式: POST

请求地址: https://nbd-api.myscrm.cn/bff-nbd-qw-openapi/v1/tag/list

请求参数说明:

参数 类型 必须 说明
app_id string 企微中台应用 id
organ_proj_id string[] 关联的项目 id 列表,空则表示获取全部项目下的数据
tag_id string 查询指定的 tag 的数据
tag_name string 标签名称搜索词
pager.page int 页码,默认为 1
pager.page_size int 每页数量,建议不超过 100

请求参数示例:

{
  "app_id": "3a07bfb1-6d5a-22e2-072c-1e6a40e3f3fc",
  "tag_name": "",
  "organ_proj_id": ["3a02c82b-57b3-21ed-a964-562166b9b4cc"],
  "tag_id": "3a0a1fda-69c2-0401-192e-71c0770bfa85",
  "pager": {
    "page": 1,
    "page_size": 10
  }
}

返回数据:

{
  "errcode": 0,
  "errmsg": "ok",
  "tags": [
    {
      "tag_id": "3a0a1fda-69c2-0401-192e-71c0770bfa85",
      "tag_name": "教育",
      "app_id": "3a07bfb1-6d5a-22e2-072c-1e6a40e3f3fc",
      "organ_proj_id": "3a02c82b-57b3-21ed-a964-562166b9b4cc",
      "organ_proj_name": "明源公馆",
      "count_materials": "1",
      "creator_name": "源小二",
      "created_at": "2023-03-23 16:54:52"
    }
  ],
  "pager": {
    "page": "1",
    "page_size": "10",
    "total_rows": "1"
  }
}

返回参数说明:

参数 类型 说明
tags.tag_id string 标签 id
tags.tag_name string 标签名称
tags.app_id string 企微中台应用 id
tags.organ_proj_id string 关联项目 id
tags.organ_proj_name string 关联项目名称
tags.count_materials string 关联标签的素材数
tags.creator_name string 标签创建者名称
tags.created_at string 标签创建时间
pager.page string 页码
pager.page_size string 每页数量
pager.total_rows string 总行数