发送图片消息

一、上传图片

发送图片消息首先要使用上传图片接口上传媒体文件上传媒体文件。上传成功后，可获取上传图片的 CDN 地址。
示例返回结果如下：

{
    "status": "ok",
    "msg": "",
    "version": "1.0",
    "result": {
        "url": "https://chat.max-c.com/attachments/2024-09-03/1830944049440231424_bqHFSPHaIF.png"
    }
}

二、发送参数解析

字段名	类型	描述	例子
heychat_ack_id	string	用于确认消息是在频道发送重复	建议维护一个全局的累加的值,60秒内不重复
msg	string	消息内容,这个例子是带@某个人的markdown图片消息	"@{id:8829926} "
msg_type	int	消息类型	参考发送消息的参数解析中的消息类型
img	string	图片上传CDN的地址	"https://chat.max-c.com/pic/1793554163917103104.png"
addition	string	扩展信息是将KV结构dumps成string	"{"img_files_info":[{"url":"https://chat.max-c.com/pic/1793554163917103104.png","width":194,"height":228}]}"
room_id	string	房间 ID	“366331678831519300”
channel_id	string	频道 ID，不指定房间和频道ID 无法发送	“3663316788315193000”

addtion 是将如下的json 序列化成的string

{
"img_files_info": [{
	"url": "https://chat.max-c.com/pic/1793554163917103104.png",
	"width": 194,
	"height": 228
	}]
}

字段名	类型	描述	例子
img_files_info	string	这里是一个图片信息的数组
url	string	图片的CND地址
width	int	图片的宽	194
height	int	图片的高	228

如果width和height都没有,会自动压缩图片展示效果没那么好

三、直接发送图片到频道

在发送频道消息的接口中，如果要直接发送图片到频道，需将返回的图片 CDN 地址作为img字段的参数，并在addition中声明图片的长和宽，如此加载的图片会更贴合原图。
示例如下：

{
  "heychat_ack_id": "0",
  "msg_type": 3,
  "img": "https://chat.max-c.com/pic/1793554163917103104.png",
  "addition": "{\"img_files_info\":[{\"url\":\"https://chat.max-c.com/pic/1793554163917103104.png\",\"width\":194,\"height\":228}]}",
  "channel_id": "3377790315288076288",
  "room_id": "3365307913282265088",
}

四、将图片嵌入 markdown 文本

若需将图片嵌入 markdown 文本中，需将消息类型设置为 4（普通 markdown 文本）或者 10（有 @人的 markdown 文本）。
示例如下：

{
    "msg": "@{id:8829926} ![](https://chat.max-c.com/pic/1830942626358972416.png)",
    "msg_type": 10,
    "heychat_ack_id": "1",
    "room_id": "3650716263361773568",
    "addition": "{\"img_files_info\":[{\"url\":\"https://chat.max-c.com/pic/1830942626358972416.png\",\"width\":54,\"height\":54}]}",
    "at_user_id": "8829926",
    "channel_id": "3653787044223606784",
}

发送图片形式的频道消息

发送图片消息#

一、上传图片#

二、发送参数解析#

三、直接发送图片到频道#

四、将图片嵌入 markdown 文本#

发送图片消息

一、上传图片

二、发送参数解析

三、直接发送图片到频道

四、将图片嵌入 markdown 文本