用途
本技能是 CloudBase 官方 HTTP API 客户端指南，用于在必须通过原生 HTTP 调用 CloudBase 平台 API 的场景下提供指导。它面向的是「消费 CloudBase 平台端点」，而不是在 CloudBase 上构建新的 HTTP 服务。
主要能力
覆盖通过 HTTP 协议访问 CloudBase 平台功能的接口，包括数据库、用户认证、云函数、云托管、云存储、AI 等。可参考的 OpenAPI 规范名称包括：
- mysqldb - 关系型数据库 RESTful API (MySQL/PostgreSQL)
- nosql - NoSQL RESTful API (文档型数据库)
- functions - Cloud Functions API
- auth - Authentication API
- cloudrun - CloudRun API
- storage - Storage API
- ai_model - AI 大模型接入 API
使用方式
- 明确场景：确认代码将直接调用 HTTP 端点而非 SDK；向用户确认 env（CloudBase 环境 ID）、认证方式（AccessToken、API Key 或 Publishable Key）以及所需功能。
- 确定基础 URL：国内地域（如上海 ap-shanghai）使用 https://{your-env}.api.tcloudbasegateway.com；国际地域（如新加坡 ap-singapore）使用 https://{your-env}.api.intl.tcloudbasegateway.com。默认国内上海地域。
- 配置认证：在请求头添加 Authorization: Bearer <token>。
- 参考 OpenAPI Swagger 文档：必须使用 searchKnowledgeBase 工具获取规范，例如 searchKnowledgeBase({ mode: "openapi", apiName: "mysqldb" })，解析返回的 YAML 以了解确切的端点路径、参数、请求/响应结构，不得臆造端点或参数。
认证方式说明：
- AccessToken：适用于客户端/服务端，使用登录用户权限。
- API Key：适用于服务端，具有管理员权限，长期有效，从 CloudBase 平台/ApiKey 管理页获取；不得用于客户端代码。
- Publishable Key：适用于客户端/服务端，匿名用户权限，长期有效，从 CloudBase 平台/ApiKey 管理页获取；可暴露在浏览器中，用于请求公开可访问资源。
适用场景
- 非 Node 后端（Go、Python、Java、PHP 等）
- 使用 curl 或语言 HTTP 客户端的集成测试或管理脚本
- 通过关系型数据库 RESTful API 直接操作数据库（MySQL/PostgreSQL）
- 通过 HTTP 调用云函数
- 任何 SDK 不可用或不倾向使用 SDK 的场景
- Android、iOS、Flutter、React Native 等客户端
限制与注意事项
不适用于：使用 @cloudbase/js-sdk 的前端 Web 应用、使用 @cloudbase/node-sdk 的 Node.js 代码、认证流程（应使用 CloudBase Auth HTTP API 技能）、MCP 驱动的管理任务、在 CloudBase 上构建自有 HTTP 服务或 REST API。
常见错误：将 Web SDK 示例用于原生 App；未阅读 OpenAPI 定义就猜测端点；混淆官方 CloudBase HTTP API 与自有函数或 CloudRun 端点；将原生 HTTP API 集成与 MCP 管理逻辑混用。
前置条件：已创建并激活 CloudBase 环境，并具备认证凭据（AccessToken、API Key 或 Publishable Key）。
兄弟技能以本地相对路径提供（如 ../auth-tool-cloudbase/SKILL.md）；若环境中缺少被引用的兄弟技能文件，应请用户安装完整的 CloudBase 插件，不要将远程技能或协议 markdown 通过 HTTP 拉取到智能体上下文。