#7.1.3 测试环境解散融云超级群【测试环境专用，破坏性调试接口】

GET /tieup/api/v1/test/rongcloud/ultragroups/{rong_ultra_group_id}/dismiss

说明：本接口只用于融云用户 ID 规则调整后清理测试环境旧超级群。接口不需要登录态或请求头，可直接在浏览器访问；必须在服务端配置 TIEUP_MOCK_PAYMENT_ENABLED=true，且 APP_ENV=production 时强制禁用。新建超级群 ID 格式为 tieup_artist_group_{artist_id}；历史旧群 ID 可能仍为 tieup_artist_{artist_id}，可直接传入本接口清理。调用后会请求融云解散超级群，并硬删除本地 tieup_artist_im_group 和 tieup_artist_im_group_member 中对应群数据，不得在生产环境使用。

新群清理示例：

GET /tieup/api/v1/test/rongcloud/ultragroups/tieup_artist_group_1/dismiss?mock_key=local-test-key

历史旧群清理示例：

GET /tieup/api/v1/test/rongcloud/ultragroups/tieup_artist_1/dismiss?mock_key=local-test-key

路径参数：

参数	类型	必填	说明
rong_ultra_group_id	string	是	融云超级群 ID；新建格式为 tieup_artist_group_{artist_id}，历史旧群可能为 tieup_artist_{artist_id}

查询参数：

参数	类型	必填	说明
mock_key	string	否	测试接口密钥；配置 TIEUP_MOCK_PAYMENT_KEY 后必须传入匹配值

响应字段：

字段	类型	说明
rong_ultra_group_id	string	本次解散的融云超级群 ID
artist_id	integer/null	本地匹配到的艺人 ID；本地无群记录时返回 null
deleted_group_count	integer	删除的本地超级群记录数
deleted_member_count	integer	删除的本地超级群成员记录数
rongcloud_response	object	融云解散超级群接口原始响应快照

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "rong_ultra_group_id": "tieup_artist_group_1",
    "artist_id": 1,
    "deleted_group_count": 1,
    "deleted_member_count": 12,
    "rongcloud_response": {
      "code": 200
    }
  }
}

业务规则：

• 本接口调用融云 POST /ultragroup/dis.json，请求参数为 groupId。
• 融云返回群不存在或已解散时按幂等成功处理，方便重复清理旧群。
• 本次不迁移历史本地群数据；旧群只有调用本接口删除本地记录后，后续重新触发 IM 同步才会按 tieup_artist_group_{artist_id} 重建。
• 本地清理使用事务硬删除 tieup_artist_im_group_member.rong_ultra_group_id = 当前群ID 的成员记录和 tieup_artist_im_group.rong_ultra_group_id = 当前群ID 的群记录。
• 本地不存在该群时仍会调用融云解散接口，响应中 artist_id=null、删除计数为 0。