抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 服务端API介绍
  • 小游戏 OpenAPI SDK 总览
  • 接口调用凭证
  • 登录
  • 开放数据
  • 二维码
  • 订阅消息
  • 消息推送客服
  • 游戏礼包
  • 游戏内容安全
  • 推荐流直出游戏能力
  • 动态分享
  • 消息推送
  • 抖音客服平台-客服能力
  • Link链接
  • Schema链接
  • 游戏群标签能力
  • 设置用户群标签
  • 查询用户群标签
  • 查询用户群标签

    收藏
    我的收藏

    接口说明

    查询用户群标签(已删除的不会返回)

    基本信息

    名称描述
    HTTP URL
    https://minigame.zijieapi.com/mgplatform/api/apps/group_tag/get_user_group_tag
    HTTP Method
    POST
    Scope
    open.ttgame.mgplatform

    请求参数

    请求头
    access-token必填String
    示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
    content-type必填String
    示例:application/json
    固定值"application/json"
    Body
    mp_id必填String
    小游戏 appid
    open_id必填String
    目标用户的 open_id
    请求示例
    curl --location 'https://minigame.zijieapi.com/mgplatform/api/apps/group_tag/get_user_group_tag' \ --header 'access-token: 080112184745766e56626b6f72324f63445433655271704353413d3d' \ --header 'Content-Type: application/json' \ --data '{ "mp_id": "tt411d37a0de37d565", "open_id": "GOV.64fFjLb7xaEY" }'

    响应参数

    Body展开全部子属性
    err_msg必填String
    err_no必填Int32
    log_id必填String
    user_group_tag_list必填List
    展开子属性
    响应示例
    正常响应示例异常响应示例
    { "BaseResp": { "StatusCode": 0, "StatusMessage": "" }, "err_msg": "", "err_no": 0, "log_id": "20250723113624C502D1DD796BBE1A7E9D", "user_group_tag_list": [ { "status": 1, "tag_id": "547998720770", "template_id": "546358272258" } ] }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    20028001003
    access_token无效
    重新请求生成access_token
    20028001004
    open_id invalid
    检查入参
    20028006062
    mp_id 非法
    检查入参
    20028006066
    status 非法
    检查入参
    20028001005
    系统内部错误,请重试