发送带图片的消息卡片
更新时间:2026-05-29 20:51:13

发送带图片的消息卡片

卡片消息中若包含图片内容,则需先将图片上传至网盘后,使用返回的fileId进行图片标识发送卡片消息。图片上传的详细步骤:

  • 发起预签上传请求:携带access_token发起预签上传请求成功后返回 文件预签地址(url)文件id(fileId) ,具体调用接口及参数说明见 预签上传

    请求参数示例

    POST /open/api/v2/im-files/upload/pre-sign HTTP/1.1
    
    Header
    Content-Type: application/json
    accept: application/json
    Authorization: Bearer [access_token]
    timestamp: 1610544682145
    nonce: aac64aa63454457294d440d8be191254
    Referer: https://10.200.122.133/open/api/v2/im-files/upload/pre-sign
    
    Body
    {
        "fileType": 1,
        "fileName": "xx.png",
        "fileSize": 1024
    }
    

    响应参数示例

    {
        "fileId": "08ac3e7bf8e14fdda0446f2901056241", //文件id
        "url": "https://10.200.112.133/ydfs/api/v1/files/12983830ad1a4d7f97dffb5f7a4534f3.png" //文件上传地址
    }
    
  • 使用PUT请求方式将图片上传至第一步获取的 文件预签地址(url)

    请求示例

    PUT https://10.200.112.133/ydfs/api/v1/files/12983830ad1a4d7f97dffb5f7a4534f3.png //文件上传地址
    
  • 上传完图片后,将第一步获取的 文件id(fileId) 作为参数 imageId 的参数值即可发送上传的图片

  • 包含图片的卡片消息结构体如下 (示例只包含图片组件的必填参数)

{
	"elements": [
		{
			"tag": "image",
			"imageId": "802e42015ffa494195b9b3505b9a6c99" //文件id
		}
	]
}
本页目录