评论朋友圈

评论朋友圈。响应中的评论内容为 base64。

POST/qingluan/api/friend/commentSns

在线调试鉴权与基础约定

接口说明

评论朋友圈。响应中的评论内容为 base64。

⚠️ 返回的 commentId 恒为 0，不是真实 ID。删除该评论需先调「获取朋友圈详情」，从 commentList[].commentId 取真实 ID。

请求参数

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

Content-Type：application/json

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

appidstring必填

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

字段示例："we_xxxxxxxxxxxxxxx"

sidint64必填

朋友圈动态 ID。取自「查询朋友圈列表」。⚠️ 列表返回的是字符串，此处需传整数。

字段示例：7658992575255311000

contentstring必填

内容

评论正文，纯文本字符串。

字段示例："评论内容122333"

refCommentIdint64必填

某评论的commentId

注意：传 0 = 发顶层评论（不回复任何人），调用成功。传真实 commentid（回复某条评论）未确认；契约标必填，但省略后是否报错未做对照验证。

字段示例：3

响应与结果确认

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

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

响应字段与 HTTP 状态

HTTP 200

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

application/json

查看响应字段定义

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

codeinteger必填

业务状态码

业务状态码：0 表示成功，-1 表示失败；失败原因见 message。

字段示例：0

dataobject可选

业务数据

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

baseRspobject可选

基础响应体，含 ret 字段

retint64可选

内部返回码，0 为正常

注意：0。本接口没有 sendSns 那种额外的顶层 ret 字段。

commentIdint64可选

评论 ID。朋友圈评论 ID。由 /api/friend/commentSns 返回

注意：恒为 0，不是可用的评论 ID。 契约在 deleteSnsComment 处称「commentId 由 commentSns 返回」——该说法与实际不符。要删评论请改从 getSnsList / 动态对象的 commentList[].commentid 取值。

detailstring可选

错误详情

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

messagestring必填

响应消息

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

字段示例："ok"

timestring必填

服务端时间

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

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

HTTP 403

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

HTTP 404

appid 不存在或无权访问

请求示例

请求示例 · JSON

{
  "appid": "we_xxxxxxxxxxxxxxx",
  "content": "[示例] 测试评论",
  "refCommentId": 0,
  "sid": 1000000000000000021
}

响应示例

HTTP 200 响应示例 · JSON

{
  "code": 0,
  "data": {
    "baseRsp": {
      "retCode": 0
    },
    "commentId": 0
  }
}

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

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