开放平台

身份认证

使用个人访问令牌（PAT）进行 Castrel API 认证。

创建个人访问令牌

登录 Castrel 后，打开 设置 → 个人访问令牌
点击 创建令牌
填写：
- 令牌名称：起一个易于辨识的名字，如 ci-script 或 local-dev（1–100 字符）
- 过期时间：可选 30 天 / 90 天 / 1 年 / 永不过期
点击确认创建
创建成功后请立即复制并保存令牌，关闭弹窗后将无法再次查看

使用个人访问令牌

在 HTTP 请求头中传入 Bearer Token：

curl -X POST "https://<your-instance>/personal/v1/knowledge/list" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{"page_num": 1, "page_size": 20}'

Python 示例

import requests

headers = {
    "Authorization": "Bearer <your-token>",
    "Content-Type": "application/json",
}

resp = requests.post(
    "https://<your-instance>/personal/v1/knowledge/list",
    headers=headers,
    json={"page_num": 1, "page_size": 20},
)
print(resp.json())

创建或更新知识

curl -X POST "https://<your-instance>/personal/v1/knowledge/upsert" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "常用运维命令", "content": "## 磁盘检查\n```bash\ndf -h\n```"}'