批量下线微信实例

将指定微信实例从平台下线。适合后台管理、运维处理或账号迁移场景。

接口地址： POST /member/offline

注意

此接口会影响传入列表中的微信实例在线状态。调用前请确认 wcIds 来源正确，并在业务系统中记录操作人和操作原因。

前置条件

• 当前请求已携带有效 Authorization。
• wcIds 中的微信 ID 均属于当前开发者账号或指定账号可操作范围。
• 调用方已确认这些微信实例可以下线。

请求参数

参数名	必选	类型	说明
account	是	string	开发者账号
wcIds	是	array	需要下线的微信 ID 列表

请求示例

{
  "account": "1234567890",
  "wcIds": [
    "wxid_1r6wafuhou3e22",
    "wxid_wl9qchkanp9u22"
  ]
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	null	无返回数据

成功响应

{
  "code": "1000",
  "message": "成功",
  "data": null
}

错误响应

{
  "code": "1001",
  "message": "失败",
  "data": null
}

使用建议

• 批量下线前建议先备份或记录实例当前在线状态。
• wcIds 不要从用户输入直接透传，应先做权限和格式校验。
• 如只想退出当前平台账号，请使用退出平台接口。