获取收藏夹列表

同步当前微信实例的收藏夹列表。

接口地址： POST /weChatFavorites/favSync

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 首次同步时 keyBuf 传 null。
• 如果响应中 continueFlag 为 1，说明还有下一页，需要继续用响应中的 keyBuf 发起下一次同步。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
keyBuf	是	byte[]/null	同步游标；首次传 null，后续传上一次响应返回的 keyBuf

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data.ret	int	接口状态，0 表示成功
data.favList	array	收藏列表
data.keyBuf	byte[]/null	下一次同步需要使用的游标
data.continueFlag	int	0 表示同步结束，1 表示还需要继续同步
data.favList[].favId	int	收藏 ID
data.favList[].type	int	收藏类型
data.favList[].updateTime	long	收藏更新时间戳

请求示例

{
 "wId": "0000016e-c561-9bbd-0001-3dc796084901",
 "keyBuf": null
}

成功响应

{
 "message": "成功",
 "code": "1000",
 "data": {
 "ret": 0,
 "favList": [
 {
 "favId": 1,
 "type": 2,
 "updateTime": 1538560491
 }
 ],
 "keyBuf": null,
 "continueFlag": 0
 }
}

错误响应

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

使用建议

• 业务侧应循环同步，直到 continueFlag 为 0 后再认为列表同步完成。
• 建议保存每条收藏的 favId、type、updateTime，详情内容按需再调用「获取收藏夹内容」。
• 收藏列表可能较多，建议后台任务分批同步，避免用户请求长时间阻塞。