外观
发送消息
约 323 字大约 1 分钟
2025-05-28
1. 接口地址
{$host}/im/message/send2. 请求方式
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 |