调用Vimeo API获视频播放量遇Too many API requests错误求助

针对你遇到的「Too many API requests」错误，结合你的代码和Vimeo API的规则，我整理了几个实用的解决思路：

1. 确认API速率限制配额及当前使用情况 #

Vimeo API的速率限制信息会返回在响应头中，你可以先打印这些信息，明确自己的配额和剩余请求数：

• 在请求后添加代码查看响应头：

  var_dump($video_details['headers']);
  

• 重点关注这几个字段：
  • X-RateLimit-Limit：你的token总共允许的请求次数
  • X-RateLimit-Remaining：当前剩余的可用请求数
  • X-RateLimit-Reset：配额重置的Unix时间戳（可计算还需等待多久）

如果发现X-RateLimit-Limit数值很小（比如只有几十次），说明你当前使用的token类型配额不足。

2. 更换为「个人访问令牌」提升配额 #

你当前代码中使用的token可能是客户端凭证令牌（Client Credentials Token），这类令牌的速率限制配额很低，适合匿名访问公开内容。而个人访问令牌（Personal Access Token）的配额要高得多，适合服务器端的业务逻辑：

• 登录Vimeo开发者控制台，进入「My Apps」选择你的应用
• 在「Authentication」标签下生成个人访问令牌，勾选需要的权限（比如public、video_read）
• 把代码中的$access_token替换成这个新生成的令牌

3. 优化请求逻辑，减少冗余调用 #

你的代码中请求单个视频时带了['per_page' => 2]参数，这个参数是用于列表类接口（比如/videos）分页的，单个视频请求完全不需要，去掉它可以避免不必要的API处理开销：

// 优化后的请求代码
$video_details = $lib->request('/videos/'.$video_id, [], 'GET');

另外测试时不要短时间内重复发送请求，比如循环测试时添加sleep(1)延迟，避免快速耗尽配额。

4. 实现自动重试机制 #

当触发9003错误时，不要直接终止，而是根据响应头的重置时间自动等待后重试：

// 请求后检查错误
if (isset($video_details['error']) && strpos($video_details['error'], 'Too many API requests') !== false) {
    $reset_time = $video_details['headers']['X-RateLimit-Reset'];
    $wait_seconds = max(0, $reset_time - time());
    
    echo "请求超限，将等待 {$wait_seconds} 秒后重试...\n";
    sleep($wait_seconds);
    
    // 重新发起请求
    $video_details = $lib->request('/videos/'.$video_id, [], 'GET');
}

// 获取播放量
if (isset($video_details['body']['stats']['plays'])) {
    echo "视频播放量：" . $video_details['body']['stats']['plays'];
}

内容的提问来源于stack exchange，提问作者jose suarez