SuperAPI AI 工具集

http-api-cloudbase

编程与开发

查看项目

更新于 10-16 08:41

技能介绍

用途:当后端、脚本或非 SDK 客户端需要通过原生 HTTP 调用 CloudBase 官方平台接口时使用本技能。适用于 Android、iOS、Flutter、React Native、非 Node 后端,以及使用 curl 或语言 HTTP 客户端的集成测试与管理脚本。注意:本技能用于消费 CloudBase 平台端点,而非在 CloudBase 上自建 HTTP 服务。

主要能力:通过 HTTP 访问数据库、用户认证、云函数、云托管、云存储、AI 等平台功能。可用 API 名称包括 mysqldb(关系型数据库 RESTful API,MySQL/PostgreSQL)、nosql(文档型数据库)、functions(云函数)、auth(认证)、cloudrun(CloudRun)、storage(存储)、ai_model(AI 大模型接入)。

使用方式:先确认场景为直接调用 HTTP 端点而非 SDK,获取 env(环境 ID)与认证方式(AccessToken、API Key 或 Publishable Key),并确认所需功能。基础 URL 按地域选择:国内如上海用 https://{your-env}.api.tcloudbasegateway.com,国际如新加坡用 https://{your-env}.api.intl.tcloudbasegateway.com。请求头加 Authorization: Bearer <token>。实现前必须用 searchKnowledgeBase 工具获取 OpenAPI 规范,例如 searchKnowledgeBase({ mode: "openapi", apiName: "mysqldb" }),据返回的 YAML 解析端点路径、参数与请求响应结构,不得臆造端点或参数。认证配置可参考 ../auth-tool-cloudbase/SKILL.md,MySQL MCP 管理参考 ../relational-database-mcp-cloudbase/SKILL.md。

适用场景:非 Node 后端、curl 或语言 HTTP 客户端的集成测试与管理脚本、关系型数据库 RESTful 操作、HTTP 调用云函数等无 SDK 或不便用 SDK 的场景。

限制:不适用于 Web SDK、小程序 SDK 或 MCP 驱动的管理任务,也不用于在 CloudBase 上自建 HTTP 服务或 REST API;认证流程应使用专门的认证 HTTP API 技能。API Key 仅限服务端使用,不得写入客户端代码;Publishable Key 可暴露于浏览器,用于公开资源请求。切勿将 Web SDK 示例用于原生 App,不要混淆官方 HTTP API 与自建函数或 CloudRun 端点,也不要将原生 HTTP 集成与 MCP 管理逻辑混用。实现前请阅读 HTTP API Routing Checklist。若引用的同级技能文件缺失,请让用户安装完整 CloudBase 插件,不要将远程技能或协议 markdown 抓取进代理上下文。