服务端 API 接口文档
文档中心/LG 开放平台/批量导入历史消息
批量导入历史消息
更新时间:2026/08/18

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

🔧请求信息

请求 URI

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

请求头参数

Header必填说明
AuthorizationBearer {API Key},接口鉴权,所有请求均需携带
Content-Type仅 POST/PUT 携带 JSON 请求体时需要,值为 application/json

请求路径参数

参数类型必填说明
session_idinteger会话 ID

请求体参数

字段类型必填说明
user_idstring外部用户标识
messagesarray消息数组,最多 200 条
messages[].rolestringuserassistant
messages[].contentstring消息内容,空内容会被跳过
messages[].created_atstringISO 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_countinteger成功导入的消息条数
session_idinteger会话 ID

⚠️错误码

错误码

error_codeHTTP说明
SESSION_NOT_FOUND404会话不存在或无权访问
INVALID_QUERY_PARAMETER400请求参数错误