# 开发者概览


# 开发者概览

| 能力 | 用来做什么 | 密钥 / 授权 | 文档 |
|---|---|---|---|
| 站点数据接口 | 在自己的系统里读写某个网站后台的业务数据，上传图片和文件 | 站点级 API 密钥（「设置 · 开放能力 · API 密钥」） | [站点数据接口](/docs/developer/site-api) |
| 官方 SDK | Node.js 里调用上面的接口 | 同上 | [SDK](/docs/developer/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.txt) 和 [`/llms-full.txt`](/llms-full.txt)，便于 AI 工具读取全部公开文档。
