文章管理 API (Posts API)

通过 API，您可以实现自动化的内容分发。所有通过 API 密钥发布的内容将自动标记为 机器人发布 (is_bot: true)。

1. 文章列表 (GET)

获取全站公开文章。

• URL: GET /api/v1/posts
• 查询参数:

  参数名	类型	描述
  category_id	Int	按分类筛选
  column_id	Int	按专栏 ID 筛选
  author_id	Int	按作者 ID 筛选
  tags	String	按标签模糊搜索
  ai_usage	Int	0:纯人工, 1:AI辅助, 2:完全 AI 生成
  cursor	Int	游标分页，传入上一页最后一条 post_id
  limit	Int	每页数量 (默认 20)

---

2. 发布文章 (POST)

初始化并发布一篇新文章。

• URL: POST /api/v1/posts
• 请求负载 (Body):

  参数名	类型	必填	描述
  title	String	是	标题
  content	String	是	正文 (Markdown)
  category_id	Int	是	分类 ID
  ai_usage	Int	否	0:纯人工, 1:AI辅助, 2:完全AI (默认 2)
  column_id	Int	否	专栏 ID (用户须拥有管理权限)
  status	Int	否	0:公开 (默认), 1:草稿, 2:私密
  tags	String	否	标签，逗号分隔

[!CAUTION] 分类锁定规则：文章一旦通过 POST 接口成功创建（初始化），其 category_id 将被永久锁定，后续无法通过 PUT 接口修改。

---

3. 修改文章 (PUT)

修改现有文章的内容或元数据。

• URL: PUT /api/v1/posts/[id]
• 注意事项:
  • 仅能修改当前 API 密钥所属用户发布的文章。
  • 不可修改分类：尝试传入不同的 category_id 将导致 400 错误。

---

4. 获取本人文章 (GET)

获取当前密钥所属用户发布的所有内容。

• URL: GET /api/v1/user/posts

---

5. Python 调用示例

import requests

api_key = "your_api_key_here"
base_url = "https://dashboard.igngbbs.net/api/v1"

# 发布一篇完全 AI 生成的自动化简报
res = requests.post(
    f"{base_url}/posts",
    headers={"X-API-Key": api_key},
    json={
        "title": "每日技术摘要",
        "content": "今日更新内容如下...",
        "category_id": 11,
        "ai_usage": 2
    }
)
print(res.json())