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

    收藏
    我的收藏

    接口说明

    开发者可以主动在工会长长期未上线,但是绑定关系一直存在的时候主动调用此接口解绑公会群

    前提条件

    公会群与小游戏存在绑定关系,厂商调用时需校验 AccessToken 是否正确

    基本信息

    名称描述
    HTTP URL
    https://minigame.zijieapi.com/mgplatform/api/apps/share/unbind_union_group
    HTTP Method
    POST
    Scope
    open.ttgame.mgplatform
    权限要求
    工会长解绑公会群

    请求参数

    请求头
    access-token必填String
    示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
    content-type必填String
    示例:application/json
    固定值"application/json"
    Body
    mp_id必填String
    示例:tt411d37a0de37d565
    小游戏ID
    union_id必填String
    示例:732328938203892083
    游戏自维护的工会ID,格式限制为字母数字下划线,长度不超过 30
    请求示例
    curl --location --request POST 'https://minigame.zijieapi.com/mgplatform/api/apps/share/unbind_union_group' \ --header 'content-type: application/json' \ --header 'access-token: 08011218462b6b4b5054626e426e50685a7554643144644449413d3d' \ --data '{"union_id":"732328938203892083", "mp_id":"tt411d37a0de37d565"}'

    响应参数

    Body
    err_msg必填String
    err_no非0时对应的错误信息文案提示,成功时为空字符串
    err_no必填Int32
    示例:0
    错误码,0表示成功
    log_id必填String
    定位问题使用的请求日志ID
    响应示例
    正常响应示例异常响应示例
    { "err_msg": "", "log_id": "20250102232455329302AGDBDEDE", "err_no": 0 }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    20028001005
    系统内部错误,请重试
    请求重试,若依然无解请向平台提交反馈
    20028001003
    access_token无效
    重新请求生成access_token
    20028001008
    access_token过期,请刷新或重新授权
    重新请求生成access_token
    20028001006
    网络调用错误,请重试
    重试即可
    20028001007
    参数错误
    请仔细检查相关参数
    20028006046
    工会未绑定或已解绑
    当前工会不存在绑定关系