API
了解你的网站 API 能做什么,以及谁会用到它。
什么是 API
想象一下餐厅的服务窗口:你告诉服务员想要什么菜,服务员去厨房帮你做好端出来。你不需要自己进厨房。
API 就是你网站对外提供的「服务窗口」。其他程序可以通过这个窗口,对你的网站发出指令——比如「帮我发布一篇文章」或「把所有文章导出来」。
这个网站的 API 能做什么
| 能力 | 举个例子 |
|---|---|
| 发布和管理文章 | 让 AI 写完文章后自动发到你的网站,不用手动复制粘贴 |
| 批量导入内容 | 把你在其他平台写的旧文章一次性搬过来 |
| 导出和备份 | 把所有内容打包下载,防止数据丢失 |
| 管理评论 | 批量审核、删除垃圾评论 |
| 管理图片等资源 | 上传和查看你网站里用到的图片文件 |
谁会用到 API
大多数情况下,你不需要自己直接使用 API。以下这些角色可能会用到它:
- 帮你做自动化的技术人员 — 比如让网站每天自动备份
- AI 写作工具 — 写完文章后直接发布到你的网站,不需要你手动操作
- 其他工具和平台 — 比如把你网站的内容同步到其他地方
安全机制:API Token
API Token 就像一把钥匙。只有拿到这把钥匙的程序,才能通过 API 操作你的网站。
你可以在后台设置页创建 Token,并且给每把钥匙设置不同的权限——有的只能读文章,有的能发布文章,有的能管理评论。这样即使某把钥匙泄露了,影响范围也很小。
小贴士: 就像你不会把家里的万能钥匙随便给人一样,每个 Token 应该只给它需要的最小权限。
OpenAPI 是什么
你的网站在 /openapi.json 提供了一份标准化的说明书。
这份说明书用所有程序都能读懂的格式,描述了你网站 API 的全部能力。技术人员或 AI 工具拿到这份说明书后,就能自动知道怎么跟你的网站对话,不需要一个个手动查接口。
你不需要自己打开或阅读这份文件——它是给程序看的。