API 与集成

创建 OpenAPI Token

在实例开放该功能且账户有权访问时，进入 OpenAPI Token 管理页面；系统设置也提供对应入口。为集成填写可识别名称，并按需要设置过期时间。

完整 Token 只在创建时显示一次。立即保存到服务端密钥管理位置，不要放进前端页面、URL 参数或公开仓库。停用集成时撤销对应 Token。

发起请求

网关支持通过请求头传递 OpenAPI Token：

Authorization: Bearer <OPENAPI_TOKEN>

请求发送到你自己的实例域名。使用账户权限范围内的接口；Token 不会绕过资源权限。

先发现契约，再调用

业务目录提供类型化函数与输入 schema。调用前确认目录完整路径、函数类型、action、输入字段和响应结构，先执行只读或低风险请求。

目录函数是业务能力，平台接口负责工作空间、身份、权限等通用操作。不要把内部服务端口直接暴露给外部调用方。具体接口以当前实例与对应版本源码为准。

开发自己的应用

业务应用使用独立的 kageos-sdk。平台源码位于 kageos 主仓。开发套件可从官网开发套件下载。

先本地检查，再构建到平台，最后用真实表单、表格或图表验证。仅编译通过不能证明部署后的业务能力可用。