Appearance
转发文件消息
通过原始 XML 转发已收到的文件消息。
接口地址: POST /sendRecvFile
前置条件
- 微信实例已登录,并已获得可用的
wId。 - 接收方
wcId可以是好友微信 ID,也可以是群 ID。 content需要来自已收到文件消息的回调 XML。- 该接口用于复用已收到的文件消息;发送新文件建议优先使用发送文件接口。
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| wId | 是 | string | 登录实例标识 |
| wcId | 是 | string | 接收方微信 ID 或群 ID |
| content | 是 | string | 文件消息 XML 内容 |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | string | 1000 成功,1001 失败 |
| message | string | 反馈信息 |
| data.type | int | 类型 |
| data.msgId | long | 消息 ID |
| data.newMsgId | long | 新消息 ID |
| data.createTime | long | 发送时间戳(秒) |
| data.wcId | string | 接收方 ID |
请求示例
json
{
"wId": "0000016f-a805-4715-0001-848f9a297a40",
"wcId": "jack_623555049",
"content": "<msg><appmsg appid=\"\" sdkver=\"0\"><title>报价单.pdf</title><type>6</type><appattach><totallen>248320</totallen><fileext>pdf</fileext></appattach></appmsg></msg>"
}成功响应
json
{
"code": "1000",
"message": "转发文件成功",
"data": {
"type": 6,
"msgId": 697760535,
"newMsgId": 6957007917217750754,
"createTime": 1641457929,
"wcId": "jack_623555049"
}
}错误响应
json
{
"message": "失败",
"code": "1001",
"data": null
}使用建议
- 建议保存原始文件消息回调 XML,转发时直接使用,避免手工拼接造成字段缺失。
- 文件类消息可能受微信侧文件有效期影响,过期文件建议重新上传后再发送。
- 发送成功后保存
msgId、newMsgId、createTime,便于撤回或追踪。
