appidstring必填青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"发布朋友圈。content 是字符串,不是对象。
/qingluan/api/friend/sendSns发布朋友圈。content 是字符串,不是对象。
:::check ✅ 成功判定:HTTP 200 且响应体 code = 0。业务失败请查看 message 与 detail。 :::
请求体必填。通过 QL-Key 请求头携带 APIKey。
Content-Type:application/json
请求参数。字段名区分大小写,请按文档原样传递。
appidstring必填青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"contentstring必填内容
动态正文,纯文本字符串。
字段示例:"(历史内容,已脱敏)"本接口为能力层原样返回,不统一增加青鸾外层信封。code = 0 仅表示请求被接受,不保证副作用已完成。
需要确认朋友圈变更时,可用查询朋友圈详情核对。
能力层原样返回;code = 0 仅表示请求已受理,业务结果须按接口说明确认。
application/json
接口原样返回平台的业务响应。HTTP 状态码与业务状态码需分别判断:HTTP 200 只表示请求已送达,成功以 code = 0 为准。
codeinteger必填业务状态码
业务状态码:0 表示成功,-1 表示失败;失败原因见 message。
0dataobject可选业务数据
业务返回数据;字段结构见下方定义。
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可选分页大小
单页数量。建议控制在接口推荐范围内。
最小值:1wordingstring可选提示文案
groupLimitLineDataobject可选按群组设置的朋友圈可见范围配置。
limitint64可选分页大小
单页数量。建议控制在接口推荐范围内。
最小值:1wordingstring可选提示文案
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"受控接口,需通过控制台配置
appid 不存在或无权访问