批量导入历史消息

备用功能：可导入设备端产生的对话。

请求信息

请求 URI

POST https://lg.jimitu.top/api/open/sessions/{session_id}/messages/import

请求头参数

请求头	必填	说明
Authorization	是	Bearer {API Key}，接口鉴权，所有请求均需携带
Content-Type	否	仅 POST/PUT 携带 JSON 请求体时需要，值为 application/json

请求路径参数

参数	类型	必填	说明
session_id	integer	是	会话 ID

请求体参数

字段	类型	必填	说明
user_id	string	是	外部用户标识
messages	array	是	消息数组，最多 200 条
messages[].role	string	是	user 或 assistant
messages[].content	string	是	消息内容，空内容会被跳过
messages[].created_at	string	否	ISO 8601 时间戳，保留原始时序

请求示例

curl -X POST "https://lg.jimitu.top/api/open/sessions/{session_id}/messages/import" \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "<user_id>",
    "messages": [
      { "role": "user", "content": "你好", "created_at": "（可选）" },
      { "role": "assistant", "content": "你好呀！", "created_at": "（可选）" }
    ]
  }'

响应信息

响应体示例

{
  "success": true,
  "data": {
    "imported_count": 2,
    "session_id": 1001
  }
}

响应参数

字段	类型	说明
imported_count	integer	成功导入的消息条数
session_id	integer	会话 ID

错误码

错误码

error_code	状态码	说明
SESSION_NOT_FOUND	404	会话不存在或无权访问
INVALID_QUERY_PARAMETER	400	请求参数错误