正文在微信机器人的朋友圈相关能力中获取自己的朋友圈列表是数据同步类需求的基础接口。无论是做朋友圈内容归档、互动数据统计还是多账号的朋友圈管理后台第一步都是通过微信 API把时间线数据完整拉下来。本文记录WTAPI 微信机器人接口中自己的朋友圈列表接口snsList的对接思路。接口地址为/finder/v2/api/sns/snsList采用 HTTP POST 方式调用属于微信个人号二次开发的朋友圈模块。入参有四个字段appId设备实例 ID登录后获取maxId翻页游标首次请求传 0第二页起传上一页返回的maxId它的值就是当前列表最后一条朋友圈的 snsIddecrypt是否解密默认true一般保持默认即可拿到可解析的内容firstPageMd5另一个翻页校验 key首次传空后续传上一页返回的值。这个接口的翻页设计是双游标机制maxId决定从哪一条继续往下取firstPageMd5用于保证整次翻页会话的一致性。两者必须成对保存、成对回传否则可能出现翻页中断或数据重复。返回结果中data包含snsCount本页条数、requestTime、maxId、firstPageMd5以及核心的snsList数组。每条朋友圈的主要字段有id朋友圈 ID即 snsIduserName、nickName发布者的 wxid 和昵称createTime发布时间戳snsXml朋友圈的完整原始 XML正文、图片、视频、定位等内容都在里面likeCount/likeList点赞数量与列表commentCount/commentList评论数量与列表withUserCount/withUserList提到的相关用户。入参有四个字段Unirest.setTimeouts(0,0);HttpResponseStringresponseUnirest.post(https://wx.chuapi.com/finder/v2/api/sns/snsList).header(X-finder-TOKEN,).header(Authorization,Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg).header(Content-Type,application/json).body({\n \appId\: \wx_e2PiMSX8ySDV6tQGroCDc\,\n \maxId\: 0,\n \decrypt\: true,\n \firstPageMd5\: \\\n}).asString();开发中有几个关键点第一正文和媒体内容要从snsXml里解析。文字在contentDesc节点图片或视频在ContentObject的mediaList中通过type区分如图文、小视频定位信息在location节点。建议封装统一的 XML 解析层。第二循环翻页要有终止条件当返回的snsList为空或snsCount为 0 时表示已拉到底同时要限制最大页数防止异常情况下死循环。第三素材链接建议转存。XML 中的图片、视频地址是微信 CDN 临时链接有时效性需要长期保存的话要及时下载到自己的对象存储。第四控制拉取频率。朋友圈列表属于较重的接口全量同步建议放在低峰期定时执行增量同步则可以只拉前几页、用 snsId 去重。小结自己的朋友圈列表接口的核心不在调用本身而在于maxId firstPageMd5 双游标翻页和snsXml 的结构化解析。把这两件事处理好再配合点赞评论字段的入库微信机器人的朋友圈数据采集与微信个人号二次开发的内容管理就有了完整的数据来源。
