检测好友状态

批量检测好友关系是否正常、已被对方删除、已被对方拉黑或已拉黑对方。

接口地址： POST /checkZombie

前置条件

• 微信实例已登录，并已获得可用 wId。
• 已确认待检测的 wcId 属于当前微信实例的好友列表。
• 每次最多检测 20 个好友 ID。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
wcId	是	string	好友微信 ID；多个用英文逗号分隔，每次最多 20 个

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	array	检测结果列表
data[].userName	string	好友微信 ID
data[].status	int	好友状态码，见下方状态说明

好友状态说明

状态码	说明
0	正常
1	已被对方删除
2	已被对方拉黑
3	已拉黑对方
4	功能异常
5	功能异常
6	未知状态
7	未知状态
99	未知状态

请求示例

{
  "wId": "01377f33-544c-4dc4-9184-bcbbcd3b05d0",
  "wcId": "wxid_abc123,wxid_def456,wxid_ghi789"
}

成功响应

{
  "code": "1000",
  "message": "成功",
  "data": [
    { "userName": "wxid_abc123", "status": 0 },
    { "userName": "wxid_def456", "status": 1 },
    { "userName": "wxid_ghi789", "status": 3 }
  ]
}

错误响应

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

使用建议

• 每次调用建议间隔 1-3 秒，避免频率过高。
• 检测结果应用于客户关系维护，不建议作为高频实时判断接口。
• 返回 1、2、3 时，建议同步更新本地客户状态，避免继续发送营销或通知消息。
• 返回 4、5、6、7、99 时，建议稍后重试，并结合好友列表、发送结果或回调通知综合判断。