SuperAPI AI 工具集

hootsuite-rate-limits

通用与其它

查看项目

更新于 10-16 07:06

技能介绍

用途

该技能用于处理 Hootsuite API 的速率限制、退避(backoff)与幂等(idempotency)模式。当调用方遇到速率限制错误、需要实现重试逻辑,或需要优化 API 请求时使用。资料指出,Hootsuite API 在超出限制时返回 429 Too Many Requests,并带有 Retry-After 响应头。

速率限制参考

资料以表格形式列出以下限制:

  • 通用 API:因套餐而异,按分钟计。
  • 消息调度(Message scheduling):约 100 次/小时,按小时计。
  • 媒体上传(Media upload):约 50 次/小时,按小时计。
  • 令牌刷新(Token refresh):约 10 次/小时,按小时计。

主要能力与使用方式

第一步:遵循 Retry-After 响应头

提供一个异步函数 rateLimitedRequest,接收 url 与可选请求配置。函数使用 Bearer 令牌从环境变量 HOOTSUITE_ACCESS_TOKEN 读取凭证发起 fetch。当响应状态为 429 时,读取 Retry-After 头(默认 60 秒),等待相应秒数后递归重试;否则直接返回响应。

代码示例:

async function rateLimitedRequest(url: string, options: RequestInit = {}) {
  const response = await fetch(url, {
    ...options,
    headers: { 'Authorization': `Bearer ${process.env.HOOTSUITE_ACCESS_TOKEN}`, ...options.headers },
  });

  if (response.status === 429) {
    const retryAfter = parseInt(response.headers.get('Retry-After') || '60');
    console.log(`Rate limited. Retrying in ${retryAfter}s`);
    await new Promise(r => setTimeout(r, retryAfter * 1000));
    return rateLimitedRequest(url, options); // Retry
  }

  return response;
}

第二步:基于队列的调度

使用 p-queue 创建队列,设置 concurrency 为 1、interval 为 1000 毫秒、intervalCap 为 2(即每秒 2 个请求)。queuedSchedule 函数将消息调度请求加入队列,向 https://platform.hootsuite.com/v1/messages 发送 POST 请求,请求体包含 text、socialProfileIds(数组)与 scheduledSendTime(ISO 格式时间)。

代码示例:

import PQueue from 'p-queue';

const hootsuiteQueue = new PQueue({
  concurrency: 1,
  interval: 1000,
  intervalCap: 2, // 2 requests per second
});

async function queuedSchedule(profileId: string, text: string, time: Date) {
  return hootsuiteQueue.add(() =>
    fetch('https://platform.hootsuite.com/v1/messages', {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${process.env.HOOTSUITE_ACCESS_TOKEN}`, 'Content-Type': 'application/json' },
      body: JSON.stringify({ text, socialProfileIds: [profileId], scheduledSendTime: time.toISOString() }),
    })
  );
}

前置条件

资料列出所需条件:经批准的 API 预算、响应头基线(header baseline)、仅用于草稿的沙箱配置文件(draft-only sandbox profile),以及有界队列(bounded queue)。变更操作需要幂等键(idempotency keys),并需为耗尽的工作准备经过审查的恢复路径。

输出

返回一份速率限制回执(rate-limit receipt),包含账户范围(account scope)、请求数/受限数/延迟数、重试修订版本(retry revision)、幂等状态、队列健康、草稿或公开发布断言(draft/public assertion)以及回滚引用(rollback reference)。输出中排除文案、媒体、账号句柄(handles)与凭证。

错误处理

在以下情况停止:未知配置文件、配额饱和、试图重放公开发布变更,或在恢复期间出现公开发布路径。应延迟或取消工作,而不是绕过审批或账户范围。

示例

资料给出的示例:scope=sandbox-brand; requested=100; limited=3; deferred=3; retry=v2; idempotent=pass; public_posts=0; rollback=limits-r7,用以证明有界处理。

资源与后续

资料引用 Hootsuite API FAQ 作为资源。安全相关内容参见 hootsuite-security-basics。

限制

资料未提供具体定价、套餐细节、支持的编程语言范围或完整 API 端点清单,相关事实暂未提供。