docs: 更新数据迁移文档以反映导入流程变化
- 移除手动数据转换说明,改为推荐使用管理后台的导入功能 - 在示例数据中添加缺失的 site_id 字段以保持一致性
This commit is contained in:
@@ -52,7 +52,8 @@ GET /admin/comments/export
|
||||
"content_text": "很棒的文章!",
|
||||
"content_html": "很棒的文章!",
|
||||
"parent_id": null,
|
||||
"status": "approved"
|
||||
"status": "approved",
|
||||
"site_id": "blog"
|
||||
}
|
||||
]
|
||||
```
|
||||
@@ -109,11 +110,8 @@ POST /admin/comments/import
|
||||
说明:
|
||||
|
||||
- 若从 CWD 自身导出的评论数据进行恢复,可直接将 `/admin/comments/export` 接口导出的 JSON 原样提交到本接口;
|
||||
- 若从 **Twikoo** / **Artalk** 等其他评论系统迁移数据,本接口会自动识别并转换数据格式:
|
||||
- **Twikoo**: 自动映射 `nick` → `name`, `mail` → `email`, `href` → `post_slug`, `comment` → `content_text` 等字段
|
||||
- **Artalk**: 自动映射 `nick` → `name`, `page_key` → `post_slug`, `content` → `content_text` 等字段
|
||||
- 时间字段自动转换为时间戳格式
|
||||
- 非数字 ID 会自动丢弃,由数据库重新生成自增 ID
|
||||
- 若从 Twikoo / Artalk 等其他评论系统迁移数据,可通过管理后台「评论数据导入」功能
|
||||
- 上传对应的 JSON 文件,前端会自动转换为上述结构后调用本接口。
|
||||
- 数据导入采用 `INSERT OR REPLACE` 策略,若提供 `id` 字段且存在则会覆盖原有数据
|
||||
|
||||
**成功响应**
|
||||
@@ -301,7 +299,8 @@ GET /admin/export/stats
|
||||
"domain": "example.com",
|
||||
"count": 50,
|
||||
"created_at": 1738060800000,
|
||||
"updated_at": 1738147200000
|
||||
"updated_at": 1738147200000,
|
||||
"site_id": "blog"
|
||||
}
|
||||
],
|
||||
"likes": [
|
||||
@@ -309,7 +308,8 @@ GET /admin/export/stats
|
||||
"id": 1,
|
||||
"page_slug": "https://example.com/blog/hello-world",
|
||||
"user_id": "some-user-id",
|
||||
"created_at": 1738060800000
|
||||
"created_at": 1738060800000,
|
||||
"site_id": "blog"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user