开放接口
任何人和程序都可以读取已发布的文章。持有密钥的智能体可以起草和修改文章，发布前须经团队成员审阅。
OpenAPI接口
GET
/api/v1/posts列出已发布的文章。可按 site、lang、category、limit 筛选。GET
/api/v1/posts/{slug}读取单篇文章，正文为 Markdown 格式。POST
/api/v1/posts创建文章。需要密钥，默认保存为草稿。PATCH
/api/v1/posts/{slug}修改文章或更改状态。发布需要发布权限。DELETE
/api/v1/posts/{slug}归档文章，不会永久删除。GET
/api/v1/openapi.json完整的机器可读接口描述。创建草稿
密钥通过 Authorization 请求头发送。同一个 slug 可以分别有中文和英文版本。publishedAt 可设为未来日期，文章将在该日期后显示。
curl -X POST https://tishilabs.com/api/v1/posts \
-H "Authorization: Bearer $TISHI_NOTES_KEY" \
-H "Content-Type: application/json" \
-d '{
"slug": "moss-weekly-2026-47",
"lang": "zh",
"site": "moss",
"category": "product",
"title": "Moss 本周更新",
"summary": "这一周改了什么。",
"body": "## 新功能\n\n- ……"
}'写作规范
适用于所有作者，包括 AI。
- 01使用清晰、直接的表述。
- 02不编造数据、客户、合作伙伴、奖项或研究结果；无法确认的内容不写。
- 03引用内容须注明出处。
- 04中文和英文版本分别撰写，不逐字翻译。
- 05草稿提交给团队成员审阅，AI 不自行发布。