外观
发送消息
约 323 字大约 1 分钟
2025-05-28
1. 接口地址
{$host}/im/message/send
2. 请求方式
POST
3. 请求参数
3.1 Header 参数
X-Token: 授权码
3.2 Body 参数
参数名 | 必填 | 类型 | 说明 |
---|---|---|---|
conversationType | 是 | string | 会话类型:single-单聊,group-群聊 |
type | 是 | string | 消息类型:text-文本,image-图片,file-文件,video-视频,audio-音频,location-位置,card-卡片,custom-自定义 |
target | 是 | string | 接受者ID:单聊时为对端用户ID,群聊时为群聊ID |
content | 是 | string | 消息内容:包含data、at、quote元素的对象字符串,at群聊时生效,quote为引用的源消息体 |
4. 返回结果
4.1 群聊
字段 | 类型 | 说明 |
---|---|---|
id | Number | 消息ID |
groupId | String | 群聊ID |
type | String | 消息类型,详见消息类型 |
senderId | String | 发送者ID |
senderName | String | 发送者名称 |
senderAvatar | String | 发送者头像 |
content | String | 消息对象字符串 |
conversationId | String | 会话ID,即群聊ID |
conversationType | String | 会话类型,固定为group |
4.2 单聊
字段 | 类型 | 说明 |
---|---|---|
id | Number | 消息ID |
senderId | String | 发送者ID |
senderName | String | 发送者名称 |
senderAvatar | String | 发送者头像 |
receiverId | String | 接收者ID |
receiverName | String | 接收者名称 |
receiverAvatar | String | 接收者头像 |
content | String | 消息对象字符串 |
conversationId | String | 会话ID,即群聊ID |
conversationType | String | 会话类型,固定为single |