管理企业标签-获取企业标签库

POST

/cgi-bin/externalcontact/get_corp_tag_list

服务端API企业内部开发第三方应用开发

企业可通过此接口获取企业客户标签详情。
文档ID: 17298
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/92117
https://open.work.weixin.qq.com/api/doc/90001/90143/92696

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_corp_tag_list?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"tag_id":["etXXXXXXXXXX","etYYYYYYYYYY"],"group_id":["etZZZZZZZZZZZZZ","etYYYYYYYYYYYYY"]}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "tag_group": [
    {
      "group_id": "TAG_GROUPID1",
      "group_name": "GOURP_NAME",
      "create_time": 1557838797,
      "order": 1,
      "deleted": false,
      "tag": [
        {
          "id": "TAG_ID1",
          "name": "NAME1",
          "create_time": 1557838797,
          "order": 1,
          "deleted": false
        },
        {
          "id": "TAG_ID2",
          "name": "NAME2",
          "create_time": 1557838797,
          "order": 2,
          "deleted": true
        }
      ]
    }
  ]
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

group_id

array[string]

可选

要查询的标签组id，返回该标签组以及其下的所有标签信息

tag_id

array[string]

要查询的标签id

可选

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

tag_group

array [object {6}]

标签组列表

可选

deleted

boolean

可选

create_time

integer <int32>

可选

group_id

string

可选

group_name

string

可选

tag

array [object {5}]

可选

order

integer <int32>

可选

修改于 2022-01-14 04:25:42

说明

管理企业标签-添加企业客户标签