ChatImage-发送语聊图片

测试环境

POST

/hmd-wx/api/v2/messagectx/messaging/publish/chat/image

给联系人发送语聊图片消息。

先用 Upload 接口上传文件后拿到文件 fileUrl

图片缩略图显示

这是一张OSS测试图：

https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/example.jpg

需要显示缩略图需加上参数：

?x-oss-process=image/resize,w_500,limit_0

最后得到结果：

https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_500,limit_0

参数 w_500 指的是将原图处理成 500 宽度的图片。

参数 limit_0 指的是当目标图片分辨率大于原图分辨率时，是否进行缩放。

具体细节可以参考OSS图片缩放

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

{
    "msgType": 22,
    "sendTime": {% mock 'timestamp', 'ms' %},
    "recvId": "a615767c-0d14-47ce-b2c2-c3edb7a97d61",
    "isGroup": false,
    "content": {
        "duration": 3,
        "fileType": "png",
        "fileUrl": "https://wa04-files.oss-cn-shanghai.aliyuncs.com/2024-10-29/83a635271a19e323-1730201499238.png"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/hmd-wx/api/v2/messagectx/messaging/publish/chat/image' \
--header 'X-System: MACOS' \
--header 'X-System-Version: macOS 15' \
--header 'X-Software-Version: 1.0.0' \
--header 'X-Manufacturer: Apple' \
--header 'X-Time-Zone: Asia/Shanghai' \
--header 'X-Timestamp: {% mock '\''timestamp'\'', '\''ms'\'' %}' \
--header 'X-Request-Id: {% mock '\''uuid'\'' %}' \
--header 'Localization;' \
--header 'x-device-model;' \
--header 'x-status-signal;' \
--header 'x-status-signal-max;' \
--header 'x-status-battery;' \
--header 'x-step;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "msgType": 22,
    "sendTime": {% mock '\''timestamp'\'', '\''ms'\'' %},
    "recvId": "a615767c-0d14-47ce-b2c2-c3edb7a97d61",
    "isGroup": false,
    "content": {
        "duration": 3,
        "fileType": "png",
        "fileUrl": "https://wa04-files.oss-cn-shanghai.aliyuncs.com/2024-10-29/83a635271a19e323-1730201499238.png"
    }
}'

返回响应

🟢200成功

application/json

Body

示例

成功示例异常示例

{"msgId":1848213634595368960}

修改于 2025-09-25 10:37:30

ChatEmoji-发送语聊表情

Dial-拨打视频通话

ChatImage-发送语聊图片

图片缩略图显示#

这是一张OSS测试图：#

需要显示缩略图需加上参数：#