feat(api): 增强文章API功能并更新文档

- 为文章创建和更新接口添加 `publish_time` 字段支持
- 升级 Markdown 解析器以支持表格扩展
- 增加数据库字段默认值设置,避免严格模式错误
- 禁止客户端设置 `create_time` 和 `update_time` 字段
- 更新 API 文档以反映上述更改
- 将临时文件和工具目录添加到 .gitignore
This commit is contained in:
augushong
2026-04-30 12:17:50 +08:00
parent 6f332467df
commit cbf9b21b96
3 changed files with 86 additions and 10 deletions

View File

@@ -270,11 +270,13 @@ X-API-Key: {api_key}</div>
<tr><td>poster</td><td>string</td><td></td><td>封面图 URL</td></tr>
<tr><td>type</td><td>string</td><td></td><td>文章类型,默认 "1"</td></tr>
<tr><td>status</td><td>int</td><td></td><td>状态,默认 0草稿</td></tr>
<tr><td>content_type</td><td>string</td><td></td><td>内容类型: "html"(默认) 或 "markdown"</td></tr>
<tr><td>content_type</td><td>string</td><td></td><td>内容类型: "html"(默认) 或 "markdown"<br/>当为 "markdown" 时,系统会自动将 content 转换为 HTML 存储到 content_html 字段</td></tr>
<tr><td>categorys</td><td>array</td><td></td><td>分类 ID 数组,如 [1, 2]</td></tr>
<tr><td>tags</td><td>array</td><td></td><td>标签 ID 数组,如 [1, 2]</td></tr>
<tr><td>publish_time</td><td>string</td><td></td><td>发布时间,格式为 Y-m-d H:i:s如 2024-01-15 14:30:00</td></tr>
</tbody>
</table>
<p style="color:#888;margin-top:8px;"><strong>注:</strong><code>create_time</code><code>update_time</code> 由系统自动生成,客户端无需设置也无法修改。</p>
<h4>请求示例HTML</h4>
<div class="api-code">curl -X POST \
@@ -337,11 +339,13 @@ X-API-Key: {api_key}</div>
<tr><td>desc</td><td>string</td><td></td><td>文章摘要</td></tr>
<tr><td>poster</td><td>string</td><td></td><td>封面图 URL</td></tr>
<tr><td>status</td><td>int</td><td></td><td>状态</td></tr>
<tr><td>content_type</td><td>string</td><td></td><td>内容类型: "html"(默认) 或 "markdown"</td></tr>
<tr><td>content_type</td><td>string</td><td></td><td>内容类型: "html"(默认) 或 "markdown"<br/>当为 "markdown" 时,系统会自动将 content 转换为 HTML 存储到 content_html 字段</td></tr>
<tr><td>categorys</td><td>array</td><td></td><td>分类 ID 数组(全量覆盖)</td></tr>
<tr><td>tags</td><td>array</td><td></td><td>标签 ID 数组(全量覆盖)</td></tr>
<tr><td>publish_time</td><td>string</td><td></td><td>发布时间,格式为 Y-m-d H:i:s如 2024-01-15 14:30:00</td></tr>
</tbody>
</table>
<p style="color:#888;margin-top:8px;"><strong>注:</strong><code>create_time</code><code>update_time</code> 由系统自动生成,客户端无需设置也无法修改。</p>
<h4>请求示例</h4>
<div class="api-code">curl -X POST \