# 获取素材标签列表
请求方式: 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 | 总行数 |