用途:当需要以原生 HTTP 方式调用 CloudBase 平台能力时使用本技能,例如 Go、Python、Java、PHP 等非 Node 后端,使用 curl 或语言 HTTP 客户端的集成测试与管理脚本,通过 MySQL RESTful API 直接操作数据库,或经 HTTP 调用云函数。若使用 @cloudbase/js-sdk 的前端 Web 应用、使用 @cloudbase/node-sdk 的 Node.js 代码,或专门的认证流程,应改用对应的 CloudBase Web、Node、Auth HTTP API 技能。
主要能力:覆盖数据库(MySQL RESTful API)、用户认证、云函数、云托管(CloudRun)、云存储与 AI 等平台功能。
使用方式:先确认环境 ID 与认证方式(AccessToken、API Key 或 Publishable Key),再按地域选择域名——国内如上海用 https://{your-env}.api.tcloudbasegateway.com,国际如新加坡用 https://{your-env}.api.intl.tcloudbasegateway.com,请求头加 Authorization: Bearer <token>。实现前必须用 searchKnowledgeBase 工具获取 OpenAPI Swagger 规范,apiName 可选 mysqldb、functions、auth、cloudrun、storage,并据返回的 YAML 解析端点、参数与请求响应结构,不得自行臆造端点或参数。云函数调用示例:curl -X POST "https://your-env-id.api.tcloudbasegateway.com/v1/functions/YOUR_FUNCTION_NAME" -H "Authorization: Bearer <access_token/apikey/publishable_key>" -H "Content-Type: application/json" -d '{"name": "张三", "age": 25}'。MySQL RESTful API 支持三种域名模式:/v1/rdb/rest/{table}、/v1/rdb/rest/{schema}/{table}、/v1/rdb/rest/{instance}/{schema}/{table};查询用 GET 配合 select、limit、offset、order 等参数,写入用 POST,更新用 PATCH,删除用 DELETE,且 UPDATE 与 DELETE 必须带 WHERE 条件(如 ?id=eq.1)。可用 Prefer 头控制返回,如 return=representation、return=minimal、count=exact、resolution=merge-duplicates、resolution=ignore-duplicates。
限制与注意:API Key 仅限服务端使用,绝不可放入客户端代码;Publishable Key 可暴露于浏览器,用于公开资源与匿名权限。含特殊字符的查询参数需做 URL 编码。错误响应含 code、message、requestId,需检查 HTTP 状态码(如 400、401、403、404、500、503)。认证流程中若未指定方式,默认推荐手机短信验证码,手机号须为 "+86 13800138000" 格式(国家码后带空格),并依次保存 verification_id 与 verification_token。平台另提供在线调试工具,可填写环境 ID 与参数直接测试接口。