Appearance
客户朋友圈
发圈、列表、详情、点赞、评论、删除、签名。
本模块接口全部 POST。{BASE_URL} 是含 /wx-api 的完整 API Base；直接复制接口页的请求示例。
| 接口 | 用途 | 安全级别 |
|---|---|---|
发布朋友圈/wx-api/api/friend/sendSns | 用当前账号发一条客户朋友圈，支持纯文本 / 图文 / 视频 + 可见范围 + 位置。 | 写操作 |
获取朋友圈列表/wx-api/api/friend/getSnsList | 分页拉取本账号可见的朋友圈动态流（自己 + 客户）。 | 只读 |
设置朋友圈签名/wx-api/api/friend/setSnsSignature | 设置本账号的「朋友圈签名」（个性签名文案）。 | 写操作 |
朋友圈点赞/wx-api/api/friend/likeSns | 对某条朋友圈动态点赞 / 取消点赞。 | 写操作 |
获取朋友圈详情/wx-api/api/friend/getSnsDetails | 按单个 sid 查一条朋友圈动态的完整详情（含点赞、评论、已删评论、可见范围）。 | 只读 |
发布朋友圈评论/wx-api/api/friend/commentSns | 对某条朋友圈动态发评论，或对某条评论追评（回复）。 | 写操作 |
删除朋友圈评论/wx-api/api/friend/deleteSnsComment | 删除某条朋友圈动态下的一条评论。 | 高风险 |
删除朋友圈/wx-api/api/friend/deleteSns | 删除本账号自己发布的一条朋友圈动态。 | 高风险 |
安全级别与「实测 日期」标记的含义见API 参考的表格说明。
发朋友圈
调发布朋友圈。可以带文字 content、图片或视频 mediaList、可见范围 xid、位置 poiInfo、链接 linkInfo。发布成功后，新动态的 ID 在 data.postInfo.sid。
图片和视频要先调上传大文件
mediaList 里的图片、视频必须先调上传大文件，等上传完成的推送拿到以 *1* 开头的 fileId，再填 {type, fileId, md5, size, width, height}。用上传图片或上传视频拿到的 fileId 发出去会变成纯文本，接口照样返回 code:0。
看朋友圈
- 获取朋友圈列表：按页拉动态。翻页游标是
seq，不是maxId：第一页传0，下一页传上一页最后一条的seq。列表项已经带点赞、评论、媒体和链接，一般不用再查详情。 - 获取朋友圈详情：按一个
sid查完整详情，含已删除的评论和可见范围。
点赞、评论、删除
都用动态 ID sid 定位：
| 要做的 | 接口 | 注意 |
|---|---|---|
| 点赞或取消点赞 | 朋友圈点赞 | cancel=true 是点赞，cancel=false 是取消，和字面相反 |
| 评论 | 发布朋友圈评论 | 返回的 commentId 总是 0；回复评论用的 refCommentId 目前不生效 |
| 删除评论 | 删除朋友圈评论 | commentId 要从列表或详情的 commentList[].commentId 里取 |
| 删除动态 | 删除朋友圈 | 删除后动态的 flag 变为 1，仍会留在列表和详情里，不会马上消失 |
回调字典里目前没有朋友圈类型的推送：客户发圈、点赞、评论不会推给你，本模块只覆盖主动调用的接口。
朋友圈动态字段
获取朋友圈列表的每一项和获取朋友圈详情的 data，都是同一种动态对象：
| 字段 | 类型 | 含义 |
|---|---|---|
sid | int64 | 动态 ID，点赞、评论、删除都用它 |
authorVid | int64 | 发布者的 uin；自己发的就是本账号的 uin |
seq | int64 | 动态的序列号，获取朋友圈列表翻页时传它 |
time | int | 发布时间戳（秒） |
updateTime | int64 | 最后更新时间戳（毫秒），有新评论或点赞时会变 |
content | string | 文字内容，明文，不是 base64 |
type | int | 动态类型；0 是普通的文本或图文 |
flag | int | 新发的动态是 0；删除朋友圈后变为 1 |
visibleType | int | 可见类型，取值 0 或 1，含义以客服说明为准 |
postId | string | 动态的 base64 令牌，供内部引用，不是可读的 ID |
mediaList | array | 媒体列表，见下 |
likeList | array | 点赞列表，见下 |
commentList | array | 评论列表，见下 |
deleteCommentList | array | 已删除的评论，结构同 commentList，flag 为 3 |
linkInfo | object | 链接信息 |
poiInfo | object | 位置信息 |
xid | array<int64> | 可见范围的 uin 列表；只有获取朋友圈详情返回 |
mediaList[]：{type, fileId, md5, size, width, height}；type为2是视频，3是图片。likeList[]：{xid, sid, time}；xid是点赞人的 uin，sid是所属动态，time是点赞时间戳。commentList[]：{commentId, fromId, sid, time, postId, comment, flag}；删除评论用commentId。comment是 base64 编码的评论正文，要先解码；动态本身的content是明文，两者不同。flag为2是正常评论，3是已删除。