↑

CloudBase HTTP API 开发参考v1.0.0

cloudbase-references-http-api7 KB

为无法使用 SDK 的后端服务或脚本提供 CloudBase 平台 HTTP API 接入方案，覆盖数据库、云函数、存储、认证等能力的原生 HTTP 调用方式。适用于 Go、Python、Java、PHP 等非 Node 后端，或需直接操作 MySQL RESTful API、curl 测试等场景。

0 0 0 0 更新于 2026-10-28 18:24

免责声明：本站部分 Skill 来源于公开渠道，使用前请注意识别相关风险，内容版权归原作者所有，如 Skill 涉及版权问题，请在线反馈，核实后予以下架处理。

概述

本 Skill 面向无法集成 CloudBase SDK 的运行环境，提供通过原生 HTTP 协议调用 CloudBase 全平台能力的完整方案。涵盖云数据库（MySQL RESTful API）、云函数、云存储、用户认证、CloudRun 等核心服务的接口路由、认证鉴权与请求构造规范。开发者可依据 OpenAPI Swagger 文档精确获取端点定义，避免凭空构造参数；同时内置国内与国际双地域域名规则、AccessToken / API Key / Publishable Key 三种鉴权方式的选型指引，以及 URL 编码、请求头格式等常见踩坑点的对照示例，最终输出可直接用于生产环境的 curl 命令或各语言 HTTP 客户端代码。

技能包含

  • SKILL.md（本文件）：技能主说明，包含触发条件、认证流程、域名规则、OpenAPI 查询约定及各服务调用示例
  • checklist.md：HTTP API 接入前的路由与实现检查清单

核心能力

  • 多语言后端接入：为 Go、Python、Java、PHP 等非 Node 后端提供无 SDK 的 CloudBase 调用方案
  • MySQL RESTful 直连：通过 HTTP 完成数据库的查询、插入、更新、删除及关联操作，支持自动 _openid 填充
  • OpenAPI 精准寻址：强制使用 searchKnowledgeBase 工具按 apiName 拉取官方 Swagger 定义，杜绝端点臆造
  • 三模式鉴权选型：区分 AccessToken（登录用户权限）、API Key（服务端管理员权限）、Publishable Key（匿名/公开资源）的适用场景与安全约束
  • 双地域域名适配：自动匹配国内（.api.tcloudbasegateway.com）与国际（.api.intl.tcloudbasegateway.com）环境的基地址规则
  • 云函数 HTTP 触发：提供标准 POST 调用模板与请求体构造示例

应用场景

用户怎么说本技能做什么
"我的 Python 后端需要读写 CloudBase 数据库，但不能装 SDK"给出 MySQL RESTful API 的完整基地址、请求头、select/limit/order 查询参数构造方式及 URL 编码前后对照示例
"我想用 curl 测试调用云函数，怎么拿正确的 endpoint"指导通过 searchKnowledgeBase({mode:"openapi", apiName:"functions"}) 获取精确端点，并拼接 https://{envId}.api.tcloudbasegateway.com/v1/functions/{name} 的调用命令
"服务端脚本要用管理员权限操作，该选哪种鉴权"判定场景适用 API Key，提示必须从平台控制台获取，并强调禁止暴露到客户端
"海外部署的环境，API 域名是不是不一样"根据环境所在区域切换国际域名后缀 intl.tcloudbasegateway.com，避免请求误路由至国内节点