抖音群标签 | 文档中心

文档修订记录

版本	更新日期	更新内容
3.1.1	2025.06.14	提供抖音群标签管理接口，分别查询用户群标签和设置用户群标签接口

1. 查询用户群标签接口

1.1 说明

查询用户群标签（已删除的不会返回）

1.2 Api地址

地址: https://api-combine.feiyu.com/v1/douyinMiniGame/getUserGroupTagList

1.3 请求方式

POST

1.4 请求头

"Content-type":"application/json"

1.5 请求参数

请求示例：

{
    "app_id": "30462",
    "open_id": "20224cdcd977b95c014a61aedac6516e",
    "sign": "ee451a7d5fe7dfe0a8229a069e20b6bd",
    "sign_nonce": "nKTOIE58",
    "sign_version": "1.1",
    "timestamp": "1755142832"
}

参数名	必选	类型	说明
app_id	是	string	应用ID
open_id	是	string	聚合OpenID
timestamp	是	string	10位时间戳
sign	是	string	签名值
sign_type	是	string	签名类型(默认：md5)
sign_nonce	是	string	签名随机数(随机数字+字符串共8位)
sign_version	是	string	签名版本，1.1

1.6 返回参数

参数名	类型	说明
trace_id	string	请求唯一ID
status	int	状态码, 0代表成功，非0状态码可参考如下错误码表格确认信息
message	string	返回结果描述
data	string	返回结果数据
data.user_group_tag_list	array	标签信息
data.user_group_tag_list.[].status	int	标签状态：1-已佩戴；
data.user_group_tag_list.[].tag_id	string	标签 id
data.user_group_tag_list.[].template_id	string	本期无需关注此字段，后续平台会支持多套标签体系

返回实例：

{
    "trace_id": "58308aa802b83efd05e26e1017a58a87",
    "status": 0,
    "message": "OK",
    "data": {
        "user_group_tag_list": [
            {
                "status": 1,
                "tag_id": "552505344002",
                "template_id": "551966208770"
            }
        ]
    }
}

2. 设置用户群标签接口

2.1 说明

设置用户群标签

2.2 Api地址

地址: https://api-combine.feiyu.com/v1/douyinMiniGame/setUserGroupTagList

2.3 请求方式

POST

2.4 请求头

"Content-type":"application/json"

2.5 请求参数

请求示例：

{
    "app_id": "30462",
    "open_id": "20224cdcd977b95c014a61aedac6516e",
    "status": 1,
    "tag_id": "552505344002",
    "sign": "eebc3fe6d96a4202e3f730c5886703f0",
    "sign_nonce": "t4XsuuFg",
    "sign_version": "1.1",
    "timestamp": "1755143759"
}

参数名	必选	类型	说明
app_id	是	string	应用ID
open_id	是	string	应用ID
status	是	int	用户标签状态: 1-佩戴；3-删除
tag_id	是	string	标签id (从平台上获取)
timestamp	是	string	10位时间戳
sign	是	string	签名值
sign_type	是	string	签名类型(默认：md5)
sign_nonce	是	string	签名随机数(随机数字+字符串共8位)
sign_version	是	string	签名版本，1.1

2.6 返回参数

参数名	类型	说明
trace_id	string	请求唯一ID
status	int	状态码, 0代表成功，非0状态码可参考如下错误码表格确认信息
message	string	返回结果描述
data	string	返回结果数据
data.is_sandbox_request	bool	是否为沙盒环境调用，当标签状态为「待上架」时，返回 true，表示本次调用不会对真实用户设置生效

返回实例：

{
    "trace_id": "fae674bb4cc4a86d4b6105ccc20f0af3",
    "status": 0,
    "message": "OK",
    "data": {
        "is_sandbox_request": false
    }
}

错误码

status	说明
400	错误请求，参数有误
500	未知的服务内部错误（无法拿到明确message，可联系平台研发排查问题）
4000	业务内部错误（能拿到明确message）
4002	签名校验错误

3 签名规则

3.1 MD5签名

3.1.1、获取基础接入参数

在【对接中心->渠道打包->配置参数】，：App ID（请求参数app_id）和App Secret（签名密钥）。

file

3.1.2、签名文档

参考：鉴权指南md5 - v1.1