新网AI建站文档 返回工作台

开始

开发者概览

AIDA 建站平台提供的开发者能力:站点数据接口、官方 SDK、桌面 AI 的 MCP 接入,以及代理商的用户级接口。

更新于 2026-11-15
能力用来做什么密钥 / 授权文档
站点数据接口在自己的系统里读写某个网站后台的业务数据,上传图片和文件站点级 API 密钥(「设置 · 开放能力 · API 密钥」)站点数据接口
官方 SDKNode.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 工具读取全部公开文档。