😋上传CDN图片

• URL: v2/cdnupload

• 方法: POST

• 功能: 向指定的聊天发送CDN图片。支持三种图片源：本地图片、网络图片、Base64编码图片。

查询参数

参数	类型	必需性	示例值	描述
wxid	string	必需	Wxid_xxxxxx	发送者的微信ID

请求体参数

• CgiCmd: 整型，API命令代码。

• CgiRequest: 对象，请求的具体内容，包括:

  • ToUserName: 字符串，目标聊天室ID。

  • FileType: 整型，文件类型标识（2代表图片，5代表文件）。

  • 根据图片源不同，选择以下之一:

    • FilePath: 字符串，本地图片路径。

    • FileUrl: 字符串，网络图片URL。

    • FileBase64: 字符串，图片的Base64编码。

---

请求示例

发送本地CDN图片

{
    "CgiCmd": 0,
    "CgiRequest": {
        "ToUserName": "5607240817@chatroom",
        "FileType": 2,
        "FilePath": "./running.png"
    }
}

发送网络CDN图片

{
    "CgiCmd": 0,
    "CgiRequest": {
        "ToUserName": "5607240817@chatroom",
        "FileType": 2,
        "FileUrl": "http://wwww.www.ww/1.jpg"
    }
}

发送Base64编码CDN图片

{
    "CgiCmd": 0,
    "CgiRequest": {
        "ToUserName": "5607240817@chatroom",
        "FileType": 2,
        "FileBase64": "Base64编码图片"
    }
}

---

cURL请求

curl --location -g --request POST 'http://127.0.0.1:8898/v2/cdnupload?wxid=Wxid_xxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "CgiCmd": 0,
    "CgiRequest": {
        "ToUserName": "6949093048@chatroom",
        "FileType": 2,
        "FilePath": "1.png"
    }
}'

---

成功返回

HTTP 状态码: 200 表示成功。

内容格式: JSON。

数据结构:

• CgiBaseResponse: 对象，包含操作的基础响应信息。

  • ErrMsg: 字符串，错误消息。

  • Ret: 整数，返回码。

• ResponseData: 字符串，包含上传后的图片信息，如加密键、CDN URL、图片尺寸等。

---

返回示例

{
  "CgiBaseResponse": {
    "ErrMsg": "",
    "Ret": 0
  },
  "ResponseData": "<msg><img aeskey=\"b1659aa178c7b63bd0e51da5d22debdd\" encryver=\"1\" cdnthumbaeskey=\"b1659aa178c7b63bd0e51da5d22debdd\" cdnthumburl=\"3057020100044b30490201000204d26d70fe02032f57890204ac2783b70204657944ca042461313935626630662d313262392d343334622d383966332d6663653765633039353233610204051818020201000405004c55cd00\" cdnthumblength=\"3669\" cdnthumbheight=\"73\" cdnthumbwidth=\"95\" cdnmidheight=\"0\" cdnmidwidth=\"0\" cdnhdheight=\"0\" cdnhdwidth=\"0\" cdnmidimgurl=\"3057020100044b30490201000204d26d70fe02032f57890204ac2783b70204657944ca042461313935626630662d313262392d343334622d383966332d6663653765633039353233610204051818020201000405004c55cd00\" length=\"27770\" md5=\"b1659aa178c7b63bd0e51da5d22debdd\" /></msg>"
}