青鸾QINGLUAN
控制台

发布朋友圈

发布朋友圈。content 是字符串,不是对象。

POST/qingluan/api/friend/sendSns

接口说明

发布朋友圈。content 是字符串,不是对象。

:::check ✅ 成功判定:HTTP 200 且响应体 code = 0。业务失败请查看 messagedetail。 :::

请求参数

请求体必填。通过 QL-Key 请求头携带 APIKey。

Content-Type:application/json

请求参数。字段名区分大小写,请按文档原样传递。

appidstring必填

青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。

字段示例:"we_xxxxxxxxxxxxxxx"
contentstring必填

内容

动态正文,纯文本字符串。

字段示例:"(历史内容,已脱敏)"

响应与结果确认

本接口为能力层原样返回,不统一增加青鸾外层信封。code = 0 仅表示请求被接受,不保证副作用已完成。

需要确认朋友圈变更时,可用查询朋友圈详情核对。

响应字段与 HTTP 状态

HTTP 200

能力层原样返回;code = 0 仅表示请求已受理,业务结果须按接口说明确认。

application/json

查看响应字段定义

接口原样返回平台的业务响应。HTTP 状态码与业务状态码需分别判断:HTTP 200 只表示请求已送达,成功以 code = 0 为准。

codeinteger必填

业务状态码

业务状态码:0 表示成功,-1 表示失败;失败原因见 message

字段示例:0
dataobject可选

业务数据

业务返回数据;字段结构见下方定义。

baseRspobject可选

基础响应体,含 ret 字段

retint64可选

内部返回码,0 为正常

snsInfoobject可选

已发布朋友圈的动态详情。

注意:刚发布动态的完整记录,字段与 getSnsDetails 的返回对象一一对应(缺 xid)。snsInfo.sid 是后续所有朋友圈操作的唯一入参来源,务必落库。

sidint64可选

朋友圈动态 ID。由 /api/friend/getSnsList 返回的 data[].sid 提供

注意:19 位 int64(如 7679000000000000001),已超过 JS Number.MAX_SAFE_INTEGER(≈9.007e15)。JSON 解析必须按字符串/BigInt 处理,否则末位会被四舍五入,拿去删动态会删不掉或删错。

authorVidint64可选

作者 vid

seqint64可选

同步序号

增量同步序号。首次请求通常传 0,后续传上次响应返回的序号。

timeint64可选

服务端时间

服务端时间,格式为 YYYY-MM-DD HH:mm:ss

contentstring可选

内容

消息/动态正文。纯文本类接口传字符串;媒体类传对象(把上传接口返回的 data 整体带上)

postIdstring可选

朋友圈动态内部 ID

isDeleteboolean可选

是否已删除

updateTimeint64可选

更新时间戳

taskSidint64可选

关联任务 ID

visibleTypeint64可选

可见范围类型

poiInfoobject可选

位置信息

poiNamestring可选

位置名称

longitudestring可选

经度

latitudestring可选

纬度

poiIdstring可选

位置兴趣点(POI)ID。

citystring可选

位置所在城市。

addressstring可选

居住地址

countrystring可选

位置所在国家或地区。

typeint64可选

类型

设备类型,如 iPad

notifyTimeint64可选

朋友圈通知时间,Unix 时间戳(秒)。

notifyVidint64可选

朋友圈通知关联的成员 VID。

limitLineDataobject可选

朋友圈可见范围配置。

limitint64可选

分页大小

单页数量。建议控制在接口推荐范围内。

最小值:1
wordingstring可选

提示文案

groupLimitLineDataobject可选

按群组设置的朋友圈可见范围配置。

limitint64可选

分页大小

单页数量。建议控制在接口推荐范围内。

最小值:1
wordingstring可选

提示文案

retint64可选

内部返回码,0 为正常

注意:值 3,与 data.baseRsp.ret = 0 并存。不是失败标志——同一条动态随后被成功查询/点赞/评论/删除。含义未确认,判成败请只看外层 code

detailstring可选

错误详情

错误详情;无补充信息时通常为空字符串。

messagestring必填

响应消息

业务结果消息。成功通常为 ok;企微错误通常为 错误码|错误信息

字段示例:"ok"
timestring必填

服务端时间

服务端时间,格式为 YYYY-MM-DD HH:mm:ss

字段示例:"2026-07-21 07:33:17"

HTTP 403

受控接口,需通过控制台配置

HTTP 404

appid 不存在或无权访问

搜索接口

输入关键词查找接口。最多显示 20 项。