SuperAPI AI 工具集

building-apis

编程与开发

查看项目

更新于 10-15 17:32

技能介绍

用途:在 Celigo 集成平台中构建 API,即对外暴露集成逻辑的 RESTful 端点。外部系统通过 HTTP 调用 API,请求经查询(exports)与写入(imports)处理后返回结构化响应。

两种模式:builder 模式为可视化配置,包含 request(method、relativeURI、params、bodySchema、mockRequest、transform)、routers/branches/pageProcessors 处理管道、id 为 apiRouter 的 responseRouter 及 responses;script 模式为单个 handleRequest JavaScript 函数,接收 method、headers、queryParams、body、pathParams,返回 statusCode、headers、body。另存在无 type 字段、仅有 _scriptId 与 function 的旧版 API。

关键特性:请求阶段即输入形状,响应阶段即输出,无调度器与监听器;顶层 disabled: true 可使 API 下线并返回 404。API 自身无认证,入站请求通过 Celigo API token 认证,出站调用使用管道中 exports/imports 引用的连接。每个 builder API 需恰好一个 success 与一个 fail 响应,可加 custom 响应;分支按 inputFilter 首匹配执行,末分支需设 nextRouterId: "apiRouter"。映射分两层:页面处理器的 responseMapping 用于充实记录,响应阶段的 mappings 用于构建 HTTP body。

用法:先用 celigo account search 等命令查找可复用资源,自底向上创建连接、exports、imports,再定义请求与管道,配置响应及响应路由。

限制:API 无自启动、无调度与流程运行时控制,重试由调用方决定;流程调用 API 需作为普通 HTTP 调用方通过 HTTP export/import 指向其 URL,无特殊接线。其余细节暂未提供。