Skip to content

publish_qzone_feed ​

发布 QQ 空间文字或图片动态。

此接口在已认证的服务连接中调用,账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

纯文字与图片动态均支持可见性 1(所有人)、2(好友)、5(仅自己)。图片最多 9 张,单张不超过 10 MiB。图片的 24 小时自动删除与 AI 生成标记目前仅支持 Android;Linux 传入这些图片选项会在读取或上传图片前拒绝。两项开关可以独立开启或同时开启。无图片时返回 feed、client_feed_id、server_time;有图片时返回 tid。

本地文件只可从管理员允许的媒体目录读取;不允许任意读取框架数据、密钥或系统文件。也可使用本服务的 file_transfer 已完成上传引用。

适用协议

普通图片动态适用于 Android / Linux QQ,需有效的 SKey 与空间 PsKey;图片自动删除和 AI 标记仅支持 Android。纯文本动态依赖 Android 设备材料,Linux QQ 待核验。

调用方式 ​

向已认证的 WebSocket 连接发送:

json
{
  "type": "action",
  "id": "example-1",
  "action": "publish_qzone_feed",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "content": "你好"
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数 ​

参数类型必填说明
self_idinteger是当前框架内的账号 QQ 号
protocol_idinteger是账号协议配置 ID;从 get_protocol_list 获取,必须显式传入,0 也是有效 ID
contentstring是正文内容
visibilityinteger否1 所有人;2 好友;5 仅自己;默认 1
self_delete_after_one_dayboolean否是否启用上游 24 小时自动删除;默认 false
declare_ai_generatedboolean否是否声明内容为 AI 生成;默认 false
imagesstring[]否图片来源数组,最多 9 项

返回值 ​

以下为成功响应的 data,错误通过 ok: false 与 error 返回。

字段类型说明
self_idinteger当前框架内的账号 QQ 号
tidstring图片发布成功后的新动态 ID,仅图片分支返回
feedobject本次纯文字发布返回的动态对象,仅纯文字分支返回
client_feed_idstring发布结果中的客户端动态 ID
server_timeinteger上游服务端时间

萌卡 · 自托管 QQ 机器人框架