发送视频

发送视频。先调「上传视频」，把返回的 data 整体作为 content 传入。

POST/qingluan/api/message/sendVideo

在线调试鉴权与基础约定

接口说明

发送视频。先调「上传视频」，把返回的 data 整体作为 content 传入。

请求参数

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

Content-Type：application/json

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

appidstring必填

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

字段示例："we_xxxxxxxxxxxxxxx"

conversationIdint64必填

会话 ID

会话 ID。群聊传群号，私聊传对方 uin。注意它超出 JavaScript 安全整数范围，JS 侧需按大整数处理，不要经过 Number()。

字段示例：10000000000000000

contentobject必填

内容

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

idstring必填

对象 ID。发消息返回时即 serverMsgId（撤回要用）；上传返回时即 fileId（发送/下载要用）；列表项中为该条记录 ID

字段示例："<sample-media-id>"

sizeint64必填

文件字节数。由上传接口返回

最小值：0 字段示例：873163

durationint64必填

视频或语音时长，单位以接口说明为准。

最小值：0 字段示例：4

widthint64必填

图片/视频宽度（像素）

最小值：0 字段示例：720

heightint64必填

图片/视频高度（像素）

最小值：0 字段示例：1280

thumbUrlstring必填

封面或缩略图地址。

注意：视频封面用的是公网直链而非 CDN 句柄（与 content.id 走的取件通道不同）。由 /api/cdn/uploadVideo 回执给出，原样透传即可。

字段示例："https://example.com/sample-media.jpg"

aesKeystring必填

媒体解密密钥

媒体解密密钥。由上传接口返回，发送/下载时原样回传，不要改写

字段示例："7e96d1b925cd0b8401d8350e815d13c7"

md5string必填

MD5 校验值

文件 MD5。由上传接口返回，可用于校验

字段示例："e6c6f697cd8f9be46d8890d9b985320c"

响应与结果确认

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

发送后通过拉取消息复核。超时或网络中断时，先确认结果，再决定是否重试，避免重复消息。

响应字段与 HTTP 状态

HTTP 200

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

application/json

查看响应字段定义

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

codeinteger必填

业务状态码

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

字段示例：0

dataobject可选

业务数据

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

idint64可选

对象 ID。发消息返回时即 serverMsgId（撤回要用）；上传返回时即 fileId（发送/下载要用）；列表项中为该条记录 ID

syncKeyint64可选

同步游标

同步键。下次增量同步传回

messageTypeint64可选

消息类型枚举（0=普通消息）

fromUserIdint64可选

发送方 ID

toUserIdint64可选

接收方 ID

roomIdint64可选

群聊 ID

群聊 ID。可从创建群、群列表、群详情或回调事件中获取。

contentTypeint64可选

内容类型。0=文本 14=图片（完整枚举见平台「企微错误码」章节）

sendTimeint64可选

发送时间戳（秒）

appInfostring可选

企微内部应用标识，透传字段，无需处理

senderNamestring可选

消息发送名称

contentobject可选

内容

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

pathstring可选

小程序页面路径

idstring可选

对象 ID。发消息返回时即 serverMsgId（撤回要用）；上传返回时即 fileId（发送/下载要用）；列表项中为该条记录 ID

sizeint64可选

文件字节数。由上传接口返回

最小值：0

durationint64可选

视频或语音时长，单位以接口说明为准。

最小值：0

widthint64可选

图片/视频宽度（像素）

最小值：0

heightint64可选

图片/视频高度（像素）

最小值：0

thumbUrlstring可选

封面或缩略图地址。

md5string可选

MD5 校验值

文件 MD5。由上传接口返回，可用于校验

sourcePathstring可选

服务端记录的源文件路径。仅用于定位媒体来源，通常无需业务处理。

uploadDirstring可选

服务端媒体上传目录标识。由服务端生成，客户端原样保留。

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",
  "conversationId": 1000000000000001,
  "content": {
    "id": "<sample-media-id>",
    "size": 873163,
    "duration": 4,
    "width": 1000000000000001,
    "height": 1280,
    "thumbUrl": "https://example.com/sample",
    "aesKey": "00000000000000000000000000000000",
    "md5": "00000000000000000000000000000000"
  }
}

响应示例

HTTP 200 响应示例 · JSON

{
  "code": 0,
  "data": {
    "id": 0,
    "syncKey": 0,
    "messageType": 0,
    "fromUserId": 0,
    "toUserId": 0,
    "roomId": 0,
    "contentType": 0,
    "sendTime": 0,
    "appInfo": "",
    "senderName": "",
    "content": {
      "path": "",
      "id": "",
      "size": 0,
      "duration": 0,
      "width": 0,
      "height": 0,
      "thumbUrl": "",
      "md5": "",
      "sourcePath": "",
      "uploadDir": ""
    }
  },
  "detail": "",
  "message": "ok",
  "time": "2026-07-21 07:33:17"
}

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

发送后通过拉取消息复核。超时或网络中断时，先确认结果，再决定是否重试，避免重复消息。