MakerJackie

API

了解你的网站 API 能做什么,以及谁会用到它。

什么是 API

想象一下餐厅的服务窗口:你告诉服务员想要什么菜,服务员去厨房帮你做好端出来。你不需要自己进厨房。

API 就是你网站对外提供的「服务窗口」。其他程序可以通过这个窗口,对你的网站发出指令——比如「帮我发布一篇文章」或「把所有文章导出来」。

这个网站的 API 能做什么

能力举个例子
发布和管理文章让 AI 写完文章后自动发到你的网站,不用手动复制粘贴
批量导入内容把你在其他平台写的旧文章一次性搬过来
导出和备份把所有内容打包下载,防止数据丢失
管理评论批量审核、删除垃圾评论
管理图片等资源上传和查看你网站里用到的图片文件

谁会用到 API

大多数情况下,你不需要自己直接使用 API。以下这些角色可能会用到它:

  • 帮你做自动化的技术人员 — 比如让网站每天自动备份
  • AI 写作工具 — 写完文章后直接发布到你的网站,不需要你手动操作
  • 其他工具和平台 — 比如把你网站的内容同步到其他地方

安全机制:API Token

API Token 就像一把钥匙。只有拿到这把钥匙的程序,才能通过 API 操作你的网站。

你可以在后台设置页创建 Token,并且给每把钥匙设置不同的权限——有的只能读文章,有的能发布文章,有的能管理评论。这样即使某把钥匙泄露了,影响范围也很小。

小贴士: 就像你不会把家里的万能钥匙随便给人一样,每个 Token 应该只给它需要的最小权限。

OpenAPI 是什么

你的网站在 /openapi.json 提供了一份标准化的说明书

这份说明书用所有程序都能读懂的格式,描述了你网站 API 的全部能力。技术人员或 AI 工具拿到这份说明书后,就能自动知道怎么跟你的网站对话,不需要一个个手动查接口。

你不需要自己打开或阅读这份文件——它是给程序看的。