发送大文件

发送大文件（超过 base64 直传上限）。

请求参数

参数	必填	类型	说明
`appid`	是	`string`	实例 appid，标识操作哪个已登录账号。示例：`we_xxxxxxxxxxxxxxx`
`conversationId`	是	`int64`	会话 id：单聊传对方 `userId`，群聊传 `roomId`，给自己发传当前账号 `uin`；必须是 JSON number。示例：`10786447466811918`
`content`	是	`object`	消息内容，子字段见下。示例：`{"id":"1<uploadBigFile 回调返回的 id>","name":"完整pb数据.txt","…`

content 字段

字段	类型	说明
`content.id`	`string`	取自大文件上传完成推送的 `content`，见回调字典 · 大文件上传完成（id 以 `1` 开头）
`content.name`	`string`	取自大文件上传完成推送的 `content`，见回调字典 · 大文件上传完成
`content.url`	`string`	链接 / 资源地址
`content.size`	`int64`	取自大文件上传完成推送的 `content`，见回调字典 · 大文件上传完成
`content.aesKey`	`string`	AES 下载解密密钥；CDN 存的是加密字节，下载后用它解密
`content.md5`	`string`	取自大文件上传完成推送的 `content`，见回调字典 · 大文件上传完成

请求示例

http

POST {BASE_URL}/wx-api/api/message/sendBigFile
Authorization: Bearer <你的 App Token>
Content-Type: application/json

{
  "appid": "we_xxxxxxxxxxxxxxx",
  "conversationId": 10786447466811918,
  "content": {
    "id": "*1*<uploadBigFile 回调返回的 id>",
    "name": "完整pb数据.txt",
    "url": "",
    "size": 45675521,
    "aesKey": "",
    "md5": "6cfb4f980bcf246507fdc965d3806b43"
  }
}

bash

curl -X POST '{BASE_URL}/wx-api/api/message/sendBigFile' \
  -H 'Authorization: Bearer <你的 App Token>' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "appid": "we_xxxxxxxxxxxxxxx",
  "conversationId": 10786447466811918,
  "content": {
    "id": "*1*<uploadBigFile 回调返回的 id>",
    "name": "完整pb数据.txt",
    "url": "",
    "size": 45675521,
    "aesKey": "",
    "md5": "6cfb4f980bcf246507fdc965d3806b43"
  }
}'

python

import requests

url = "{BASE_URL}/wx-api/api/message/sendBigFile"
headers = {"Authorization": "Bearer <你的 App Token>", "Content-Type": "application/json"}
body = """{
  "appid": "we_xxxxxxxxxxxxxxx",
  "conversationId": 10786447466811918,
  "content": {
    "id": "*1*<uploadBigFile 回调返回的 id>",
    "name": "完整pb数据.txt",
    "url": "",
    "size": 45675521,
    "aesKey": "",
    "md5": "6cfb4f980bcf246507fdc965d3806b43"
  }
}"""

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}/wx-api/api/message/sendBigFile";
String body = "{\n" +
    "  \"appid\": \"we_xxxxxxxxxxxxxxx\",\n" +
    "  \"conversationId\": 10786447466811918,\n" +
    "  \"content\": {\n" +
    "    \"id\": \"*1*<uploadBigFile 回调返回的 id>\",\n" +
    "    \"name\": \"完整pb数据.txt\",\n" +
    "    \"url\": \"\",\n" +
    "    \"size\": 45675521,\n" +
    "    \"aesKey\": \"\",\n" +
    "    \"md5\": \"6cfb4f980bcf246507fdc965d3806b43\"\n" +
    "  }\n" +
    "}";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder(URI.create(url))
    .header("Authorization", "Bearer <你的 App Token>")
    .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}/wx-api/api/message/sendBigFile';
$body = <<<'JSON'
{
  "appid": "we_xxxxxxxxxxxxxxx",
  "conversationId": 10786447466811918,
  "content": {
    "id": "*1*<uploadBigFile 回调返回的 id>",
    "name": "完整pb数据.txt",
    "url": "",
    "size": 45675521,
    "aesKey": "",
    "md5": "6cfb4f980bcf246507fdc965d3806b43"
  }
}
JSON;

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

响应示例

响应结构与发送文本消息相同

成功时 data 就是刚发出的完整消息，字段见发送文本消息的响应示例。data.content 回显你发送的内容或上传字段，形状随消息类型不同，见消息模块总览的码表。

响应字段

字段	类型	说明
`code`	`int64`	统一封套状态码：0=成功，负数=失败
`detail`	`string`	附加明细，通常为空
`message`	`string`	文案：成功为 ok；失败形如 -码\|描述
`time`	`string`	服务端处理时间 YYYY-MM-DD HH:MM:SS

常见错误

下表为企微错误码。业务失败时顶层 code=-1，具体错误码在 message 的 | 前，例如 -3004|参数错误；鉴权与网关错误见错误码。

错误码	含义	怎么办
`-4014`	过期或错误的 `uin` 作 `conversationId`	先 `personal/getInfo` 取当前 `uin`
`-3020`	用自聊伪房间 `roomId` 作发送目标	给自己发用当前账号 `uin`
`-3004`	参数错误	检查字段名与类型，数字 id 不能传字符串

发送大文件 ​

请求参数 ​

请求示例 ​

响应示例 ​

响应字段 ​

常见错误 ​

下一步 ​