发送消息

接口说明

向指定会话发送一条消息。默认类型为 text，发送媒体消息时需要在 extra 中提供对应的附加字段。

请求信息

项目	内容
方法	POST
URL	https://devapi.fengshengshou.com/api/messages/conversations/{id}/messages
鉴权	是，需在请求头携带 Token

请求参数

参数名	类型	必填	说明
id	int	是（路径参数）	会话 ID
type	string	否	消息类型，可选值：text、image、file、audio、video、location，默认 text
content	string	是	消息内容，最长 5000 个字符
extra	object	否	媒体附加信息，不同类型需要不同子字段，详见下表

extra 子字段说明：

子字段名	类型	说明
name	string	文件名称，图片 / 文件 / 视频消息需要，最长 255 个字符
size	int	文件大小（字节），图片 / 文件 / 视频消息需要
url	string	资源访问地址，图片 / 文件 / 音频 / 视频消息需要，最长 2048 个字符
path	string|null	文件存储路径，可为空
mime_type	string|null	文件 MIME 类型，可为空
duration	int	音频时长（秒），音频消息需要
latitude	float	纬度，位置消息需要，范围 -90 ~ 90
longitude	float	经度，位置消息需要，范围 -180 ~ 180
address	string|null	地址描述，可为空，最长 500 个字符

请求示例

curl -X POST "https://devapi.fengshengshou.com/api/messages/conversations/101/messages" \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "text",
    "content": "大家好，今天下午三点开会。"
  }'

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	提示信息
data.id	int	消息 ID
data.conversation_id	int	会话 ID
data.sender_id	int	发送者用户 ID
data.sender_name	string|null	发送者名称，可为空
data.sender_avatar	string|null	发送者头像 URL，可为空
data.is_self	bool	是否为当前用户发送
data.type	string	消息类型
data.content	string	消息原始内容
data.display_content	string	消息展示内容（已处理）
data.extra	object|null	媒体附加信息，可为空
data.time	string	发送时间，格式 H:i
data.created_at	string	发送时间，格式 Y-m-d H:i:s

成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "id": 2048,
    "conversation_id": 101,
    "sender_id": 5,
    "sender_name": "张三",
    "sender_avatar": "https://devapi.fengshengshou.com/storage/avatars/5.png",
    "is_self": true,
    "type": "text",
    "content": "大家好，今天下午三点开会。",
    "display_content": "大家好，今天下午三点开会。",
    "extra": null,
    "time": "15:00",
    "created_at": "2026-07-05 15:00:00"
  }
}

失败响应

{
  "code": 403,
  "message": "无权访问此会话",
  "data": null
}

{
  "code": 400,
  "message": "媒体消息必须包含 url 或 path",
  "data": null
}