发送视频消息

通过公网视频地址向好友或群聊发送视频消息。

性能建议

在已授权场景中复用媒体素材时，请先阅读 API 使用与安全。

接口地址： POST /sendVideo

前置条件

• 微信实例已登录，并已获得可用 wId。
• 接收方 wcId 可以是好友微信 ID，也可以是群 ID。
• path 需要是微信客户端可访问的视频公网 URL。
• thumbPath 需要是视频封面公网 URL，建议 50KB 以内。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
wcId	是	string	接收方微信 ID 或群 ID
path	是	string	视频 URL
thumbPath	是	string	视频封面 URL，建议 50KB 以内

响应参数

参数名	类型	说明
code	string	1000 成功；其他值都是失败，通常是 1001
message	string	反馈信息
data.type	int	类型
data.msgId	long	消息 ID
data.newMsgId	long	新消息 ID
data.createTime	long	发送时间戳（秒）
data.wcId	string	接收方 ID

请求示例

HTTP

POST {BASE_URL}/sendVideo
Authorization: Bearer <你的调用凭证>
Content-Type: application/json

{
  "wId": "0000016e-a1f1-f0d9-0002-425ea1a28d22",
  "wcId": "jack_623555049",
  "path": "https://wkgjonlines.oss-cn-shenzhen.aliyuncs.com/movies/20191113/d7c616569ac342ad1fa8e3301682844e.mp4",
  "thumbPath": "http://pic23.nipic.com/20120902/8068495_150602391000_2.jpg"
}

curl

curl -X POST '{BASE_URL}/sendVideo' \
  -H 'Authorization: Bearer <你的调用凭证>' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "wId": "0000016e-a1f1-f0d9-0002-425ea1a28d22",
  "wcId": "jack_623555049",
  "path": "https://wkgjonlines.oss-cn-shenzhen.aliyuncs.com/movies/20191113/d7c616569ac342ad1fa8e3301682844e.mp4",
  "thumbPath": "http://pic23.nipic.com/20120902/8068495_150602391000_2.jpg"
}'

Python

import requests

url = "{BASE_URL}/sendVideo"
headers = {"Authorization": "Bearer <你的调用凭证>", "Content-Type": "application/json"}
body = """{
  "wId": "0000016e-a1f1-f0d9-0002-425ea1a28d22",
  "wcId": "jack_623555049",
  "path": "https://wkgjonlines.oss-cn-shenzhen.aliyuncs.com/movies/20191113/d7c616569ac342ad1fa8e3301682844e.mp4",
  "thumbPath": "http://pic23.nipic.com/20120902/8068495_150602391000_2.jpg"
}"""

resp = requests.post(url, headers=headers, data=body.encode("utf-8"))
print(resp.text)

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String url = "{BASE_URL}/sendVideo";
String body = "{\n" +
    "  \"wId\": \"0000016e-a1f1-f0d9-0002-425ea1a28d22\",\n" +
    "  \"wcId\": \"jack_623555049\",\n" +
    "  \"path\": \"https://wkgjonlines.oss-cn-shenzhen.aliyuncs.com/movies/20191113/d7c616569ac342ad1fa8e3301682844e.mp4\",\n" +
    "  \"thumbPath\": \"http://pic23.nipic.com/20120902/8068495_150602391000_2.jpg\"\n" +
    "}";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder(URI.create(url))
    .header("Authorization", "Bearer <你的调用凭证>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

PHP

<?php

$url = '{BASE_URL}/sendVideo';
$body = <<<'JSON'
{
  "wId": "0000016e-a1f1-f0d9-0002-425ea1a28d22",
  "wcId": "jack_623555049",
  "path": "https://wkgjonlines.oss-cn-shenzhen.aliyuncs.com/movies/20191113/d7c616569ac342ad1fa8e3301682844e.mp4",
  "thumbPath": "http://pic23.nipic.com/20120902/8068495_150602391000_2.jpg"
}
JSON;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer <你的调用凭证>',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

成功响应

{
 "code": "1000",
 "message": "发送视频消息成功",
 "data": {
 "type": null,
 "msgId": 697760511,
 "newMsgId": 3289648069366716802,
 "createTime": null,
 "wcId": null
 }
}

错误响应

{
 "message": "失败",
 "code": "1001",
 "data": null
}

使用建议

• 视频文件建议放在稳定 CDN，避免下载超时或接收端无法播放。
• 封面图过大可能导致发送失败，建议压缩后再传入 thumbPath。
• 批量发送同一视频时，优先复用同一素材地址，并控制发送频率。