发送图片消息

POST

/finder/v2/api/message/postImage

注意

发送图片接口会返回cdn相关的信息，如有需求同一张图片发送多次，第二次及以后发送时可使用接口返回的cdn信息拼装xml调用转发图片接口，这样可以缩短发送时间

请求参数

Header 参数

Body 参数application/json

示例

{
    "appId": "wx_e2PiMSX8ySDV6tQGroCDc",
    "toWxid": "wxid_tyyu4v9ykz3712",
    "imgUrl": "http://kitimage.com/400x400"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://wx.chuapi.com/finder/v2/api/message/postImage' \
--header 'X-finder-TOKEN: ' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "wx_e2PiMSX8ySDV6tQGroCDc",
    "toWxid": "wxid_tyyu4v9ykz3712",
    "imgUrl": "http://kitimage.com/400x400"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "toWxid": "wxid_tyyu4v9ykz3712",
        "createTime": 1779173957,
        "msgId": 884714907,
        "newMsgId": 1778951978123553010,
        "type": null,
        "aesKey": "646d747a616f7462656d686268756166",
        "fileId": "3057020100044b304902010002048b061c0002033d14b902046b692fb702046a0c0a45042432643662396364352d656237382d346536622d386366652d3366316462306464613530640204052818020201000405004c511d004b0d99e7",
        "cdnThumbUrl": "3057020100044b304902010002048b061c0002033d14b902046b692fb702046a0c0a45042432643662396364352d656237382d346536622d386366652d3366316462306464613530640204052818020201000405004c511d004b0d99e7",
        "length": 1306,
        "cdnThumbLength": 1124,
        "width": 400,
        "height": 400,
        "md5": "7c3a5c07bb9e48dda13dbf9e4b52cf7f"
    }
}

修改于 2026-05-19 07:00:33

发送文件消息

发送语音消息

发送图片消息

注意#

请求参数

请求示例代码

返回响应

注意