Zoom API中开头含斜杠的UUID无法识别问题求助

API 探路者

2026-8-13

问题分析

你遇到的核心问题是URL路径中的%2F被Zoom API服务器自动解码，导致路由解析错误：

当你把开头带/的UUID转义为%2F后，服务器会自动将%2F解码回/，原本的请求路径/metrics/meetings/%2Fddcff3n348/participants会被解析成/metrics/meetings//ddcff3n348/participants。
此时API会把第二个/当作路径分隔符，将ddcff3n348识别为UUID，而非完整的/ddcff3n348，自然找不到对应会议。
而+、!这类特殊字符转义后不会触发服务器的路径分隔符解析逻辑，所以能正常请求。

解决建议

1. 使用URL安全的Base64编码替换UUID中的特殊字符

Zoom的UUID多由Base64编码生成，你可以将UUID中的/替换为_，+替换为-（这是URL安全的Base64标准格式），直接拼接进路径：

// 处理UUID：替换/为_，+为-
const safeUuid = uuid.replace(/\//g, '_').replace(/\+/g, '-');
const url = `${process.env.baseMetricsAPI}/meetings/${safeUuid}/participants${process.env.params}`;

测试时可直接把/cxDLpgQTQabC5QM7OuiQ==改成_cxDLpgQTQabC5QM7OuiQ==发起请求，大部分情况下Zoom API会识别这种格式的UUID。

2. 将UUID放在查询参数中传递

如果路径参数的方式始终有问题，可以尝试把UUID放到查询参数里，避免路径分隔符的解析冲突：

// 用encodeURIComponent编码UUID，放到query参数中
const encodedUuid = encodeURIComponent(uuid);
// 处理params拼接逻辑，避免重复的?
const paramsSuffix = process.env.params ? `&${process.env.params.slice(1)}` : '';
const url = `${process.env.baseMetricsAPI}/meetings/participants?uuid=${encodedUuid}${paramsSuffix}`;

这种方式下服务器会把UUID当作普通字符串处理，不会解码%2F为路径分隔符。