开始
开发者概览
AIDA 建站平台提供的开发者能力:站点数据接口、官方 SDK、桌面 AI 的 MCP 接入,以及代理商的用户级接口。
更新于 2026-11-15| 能力 | 用来做什么 | 密钥 / 授权 | 文档 |
|---|---|---|---|
| 站点数据接口 | 在自己的系统里读写某个网站后台的业务数据,上传图片和文件 | 站点级 API 密钥(「设置 · 开放能力 · API 密钥」) | 站点数据接口 |
| 官方 SDK | Node.js 里调用上面的接口 | 同上 | SDK |
| MCP 接入 | 让桌面 AI 助手接入网站,在本机编码、管理素材,与在线修改共用版本和发布 | 「设置 · 开放能力 · MCP 接入」里配对 | 在 MCP 接入页面查看接入说明 |
| 用户级接口 | 代理商在自己的平台里管理名下全部网站:建站、对话施工、发布、购买、子账号与免登链接 | 用户级 API 密钥(「代理中心 · API」,只对代理商开放) | 登录代理账号后查看 |
共同的约定
- 只在服务器端使用密钥。 接口不允许跨域,浏览器里调不通;SDK 在浏览器里会直接报错。
- 密钥放在请求头:
Authorization: Bearer <密钥>。不接受放在网址或请求体里。 - 密钥只在创建时显示一次,可以建多把、分别撤销。撤销后立即失效。
- 每个账号每分钟默认 300 次请求(名下所有密钥合计),超出返回 429,按
Retry-After等待后重试。 - 错误返回稳定的错误码和
request_id,联系我们排查时请带上。
交给 AI 编程工具
在「API 密钥」页点「复制给 AI 编程工具」,会得到一段说明:本站的表和字段、接口用法、SDK 安装方法和注意事项。交给 Cursor、Claude Code 这类工具,它就能写出对接代码。说明里不含密钥,只写环境变量名 AIDA_SITE_KEY。
本文档中心也提供 /llms.txt 和 /llms-full.txt,便于 AI 工具读取全部公开文档。