获取某个好友的朋友圈

分页获取指定好友的朋友圈列表。

注意

本接口返回 XML 中的图片与视频链接通常无法直接查看，需要调用获取某条朋友圈详细内容接口获取完整内容。

接口地址： POST /getFriendCircle

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 已确认目标好友 wcId。
• 首次请求 firstPageMd5 传空字符串，maxId 传 0。
• 当前微信账号对目标好友朋友圈有可见权限。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
wcId	是	string	好友微信 ID
firstPageMd5	是	string	首次传空字符串，第二页及以后传上一次响应返回的 firstPageMd5
maxId	是	long	首次传 0，后续按翻页游标传入

请求示例

{
 "wId": "0000016e-68f9-99d5-0002-3a1cd9eaaa17",
 "wcId": "wxid_6tn88z16x6ou12",
 "firstPageMd5": "",
 "maxId": 0
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data.sns	array	朋友圈列表
data.firstPageMd5	string	翻页标识，下一页请求时继续传入
data.sns[].id	string	朋友圈 ID
data.sns[].userName	string	发布者微信 ID
data.sns[].nickName	string	发布者昵称
data.sns[].createTime	long	发布时间戳
data.sns[].objectDesc	object	朋友圈内容
data.sns[].objectDesc.xml	string	朋友圈 XML 原始数据
data.sns[].objectDesc.len	int	XML 长度
data.sns[].likeCount	int	点赞数量
data.sns[].snsLikes	array	点赞列表
data.sns[].commentCount	int	评论数量
data.sns[].snsComments	array	评论列表

成功响应

{
 "message": "成功",
 "code": "1000",
 "data": {
 "sns": [
 {
 "id": "13351211557386072142",
 "userName": "wxid_6tn88z16x6ou12",
 "nickName": "远见",
 "createTime": 1591588444,
 "objectDesc": {
 "xml": "<TimelineObject>...</TimelineObject>",
 "len": 1024
 },
 "likeCount": 0,
 "snsLikes": [],
 "commentCount": 0,
 "snsComments": []
 }
 ],
 "firstPageMd5": "087ed4f0b41e46e3"
 }
}

错误响应

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

使用建议

• 好友朋友圈受可见范围影响，返回空列表时先确认目标好友是否开放可见权限。
• 图片和视频内容建议继续通过「获取某条朋友圈详细内容」解析，不要直接使用列表 XML 中的临时链接。
• 建议业务侧按好友维度分页同步，避免一次拉取过多导致请求耗时过长。