# keng 笔记 API
> keng 是一个 Markdown 笔记系统。以下是 AI Agent 使用指南。

## 认证
所有请求加 Header：
  Authorization: Bearer <your_api_key>

在 https://leedreamer.cn/keng/settings 登录后获取你的 API Key。

## 核心接口（Base: https://leedreamer.cn/keng/api）

GET    /notes                       列出笔记（支持 ?q=关键词 搜索）
POST   /notes                       创建笔记 {"content":"...","tags":[],"folder_id":null,"comment":""}
GET    /notes/{id}                  读取笔记
PUT    /notes/{id}                  更新笔记 {"content":"...","tags":[...]}
DELETE /notes/{id}                  软删除笔记
GET    /folders                     列出文件夹
POST   /folders                     创建文件夹 {"name":"名称"}
GET    /shared                      列出别人定向分享给我的笔记
POST   /notes/{id}/share            分享给好友 {"to_username":"...","permission":"read"}
POST   /notes/{id}/sharelink        生成公开只读链接 {"expires_hours":24}
GET    /sharelinks/{token}/info     读取公开分享内容（无需认证）

## 使用示例

```bash
# 列出笔记
curl -H "Authorization: Bearer <api_key>" https://leedreamer.cn/keng/api/notes

# 创建笔记
curl -X POST -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{"content":"# 标题\n内容","tags":["标签"]}' \
  https://leedreamer.cn/keng/api/notes
```

完整文档：https://leedreamer.cn/keng/api/manual