通过 HTTP 访问云函数

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

前置条件​

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

配置 HTTP 访问​

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

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

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

方式二：在 HTTP 网关绑定​

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

1. 前往 HTTP 网关
2. 在「域名关联资源」模块点击「新建」按钮
3. 配置以下信息：

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

步骤 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"}'

// 使用 fetch API
const response = await fetch('https://your-domain/your-function-path', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ name: 'CloudBase', version: '1.0' })
});

const data = await response.json();
console.log(data);

import requests

# POST 请求
response = requests.post(
    'https://your-domain/your-function-path',
    json={'name': 'CloudBase', 'version': '1.0'}
)

data = response.json()
print(data)

在云函数中处理 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}

exports.main = async (event) => {
  const { body } = event;
  
  // 解析 JSON 请求体
  const data = JSON.parse(body);
  
  return {
    statusCode: 200,
    body: JSON.stringify({
      received: data,
      processed: true
    })
  };
};

curl -X POST https://your-domain/process \
  -H "Content-Type: application/json" \
  -d '{"userId": 123, "action": "update"}'

exports.main = async (event) => {
  const { httpMethod, path, queryStringParameters, body } = event;
  
  // 路由处理
  if (path === '/users' && httpMethod === 'GET') {
    // 获取用户列表
    return {
      statusCode: 200,
      body: JSON.stringify([{ id: 1, name: 'User1' }])
    };
  }
  
  if (path.startsWith('/users/') && httpMethod === 'GET') {
    // 获取单个用户
    const userId = path.split('/')[2];
    return {
      statusCode: 200,
      body: JSON.stringify({ id: userId, name: 'User' })
    };
  }
  
  // 404
  return {
    statusCode: 404,
    body: JSON.stringify({ error: 'Not Found' })
  };
};

相关文档​

• HTTP 网关概述 - 了解 HTTP 网关的核心功能和优势
• 快速开始 - 快速入门指南
• 路由配置 - 配置灵活的路由规则
• 自定义域名配置 - 绑定自定义域名
• 云函数开发指南 - 云函数编写教程