跳到主要内容

通过 HTTP 访问云函数

通过 HTTP 网关，您可以将云函数配置为标准的 HTTP 接口，无需 SDK 即可通过 HTTP 请求调用云函数。本文档介绍如何配置云函数的 HTTP 访问以及如何处理请求和响应。

自定义域名

如果您需要为云函数绑定自定义域名（生产环境推荐），除了下方「方式一：详情页就地绑定」外，完整的自定义域名流程（添加域名、配置 SSL 证书、CDN 选择、域名所有权校验、DNS 解析等）请参考 自定义域名配置。所有通过任意入口添加的域名，都可以在 HTTP 网关 中统一查看和管理。

前置条件​

  • 已创建云开发环境
  • 已部署至少一个云函数

配置 HTTP 访问​

您可以在云函数详情页直接绑定域名（推荐），也可以在 HTTP 网关统一配置。

方式一：详情页就地绑定（推荐）​

  1. 前往 云函数，进入目标云函数的详情页
  2. 在「自定义域名」模块点击「添加域名」按钮，弹出绑定窗口
  3. 在「触发路径」中填写 HTTP 访问路径，支持 / 或自定义路径
  4. 选择自定义域名后确认，已绑定的所有域名会展示在详情页的「域名管理」列表中

方式二：在 HTTP 网关绑定​

如果您更习惯从全局视角管理域名与资源的关系，也可以在 HTTP 网关统一配置：

  1. 前往 HTTP 网关
  2. 进入 路由管理，点击「新建」按钮
  3. 配置以下信息：
配置项说明示例
关联资源类型选择「云函数」，然后选择目标云函数hello-world
域名选择默认域名、自定义域名或 *（匹配所有域名）默认域名
触发路径设置 HTTP 访问路径，支持 / 或自定义路径/api/hello

💡 提示：生产环境建议绑定已备案的自定义域名，以获得完整的服务能力。配置方法请参考 自定义域名配置。

步骤 2：测试访问​

配置完成后，访问 域名 + 触发路径 即可调用云函数：

# 示例：访问默认域名的云函数
curl https://your-env-id.<your-env-region>.app.tcloudbase.com/api/hello

发起 HTTP 请求​

配置完成后，可以使用任何 HTTP 客户端访问云函数。

# GET 请求
curl https://your-domain/your-function-path

# POST 请求
curl -X POST https://your-domain/your-function-path \
  -H "Content-Type: application/json" \
  -d '{"name": "CloudBase", "version": "1.0"}'

在云函数中处理 HTTP 请求​

接收请求信息​

当通过 HTTP 访问云函数时，函数的 event 参数会包含完整的 HTTP 请求信息：

exports.main = async (event, context) => {
  // event 对象结构
  const {
    path,                      // HTTP 请求路径，如 /api/hello
    httpMethod,                // HTTP 请求方法，如 GET、POST、PUT、DELETE
    headers,                   // HTTP 请求头对象
    queryStringParameters,     // URL 查询参数对象，如 ?name=value
    body,                      // HTTP 请求体内容（字符串格式）
    isBase64Encoded,          // body 是否为 Base64 编码
    requestContext            // 云开发环境相关信息
  } = event;
  
  // 返回响应
  return { message: 'success' };
};

示例：处理不同类型的请求​

exports.main = async (event) => {
  const { queryStringParameters } = event;
  
  // 获取查询参数
  const name = queryStringParameters?.name || 'Guest';
  
  return {
    statusCode: 200,
    body: JSON.stringify({
      message: `Hello, ${name}!`,
      timestamp: Date.now()
    })
  };
};

访问示例：

curl "https://your-domain/greet?name=CloudBase"
# 响应: {"message":"Hello, CloudBase!","timestamp":1699999999999}

相关文档​