用途
该技能用于处理 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 端点清单,相关事实暂未提供。