技能 编程开发 Grammarly API限流与重试机制

Grammarly API限流与重试机制

v20260423
grammarly-rate-limits
本技能提供了一套完整的Grammarly API限流、重试和幂等性处理方案。它包含自定义速率限制器和指数退避逻辑,用于管理API吞吐量,确保在进行高并发、大批量文档处理时,能够稳定、可靠地调用Grammarly的各项API,避免速率限制(429)带来的中断。
获取技能
413 次下载
概览

Grammarly Rate Limits

Overview

Grammarly's Text API enforces plan-dependent rate limits across its writing score, AI detection, and plagiarism endpoints. The plagiarism checker is asynchronous and requires polling, which adds complexity to rate management. Token endpoints are separately throttled at roughly 10 requests per hour, so credential rotation during high-throughput batch processing of documents (e.g., scanning an entire content library) requires careful token lifecycle management to avoid auth-layer 429s on top of API-layer throttling.

Rate Limit Reference

EndpointLimitWindowScope
Writing score100 req (Business)1 minutePer API key
AI content detection60 req (Business)1 minutePer API key
Plagiarism check (submit)30 req1 minutePer API key
Plagiarism check (poll)120 req1 minutePer API key
Token refresh10 req1 hourPer client credentials

Rate Limiter Implementation

class GrammarlyRateLimiter {
  private tokens: number;
  private lastRefill: number;
  private readonly max: number;
  private readonly refillRate: number;
  private queue: Array<{ resolve: () => void }> = [];

  constructor(maxPerMinute: number) {
    this.max = maxPerMinute;
    this.tokens = maxPerMinute;
    this.lastRefill = Date.now();
    this.refillRate = maxPerMinute / 60_000;
  }

  async acquire(): Promise<void> {
    this.refill();
    if (this.tokens >= 1) { this.tokens -= 1; return; }
    return new Promise(resolve => this.queue.push({ resolve }));
  }

  private refill() {
    const now = Date.now();
    this.tokens = Math.min(this.max, this.tokens + (now - this.lastRefill) * this.refillRate);
    this.lastRefill = now;
    while (this.tokens >= 1 && this.queue.length) {
      this.tokens -= 1;
      this.queue.shift()!.resolve();
    }
  }
}

const scoreLimiter = new GrammarlyRateLimiter(90);
const plagiarismLimiter = new GrammarlyRateLimiter(25);

Retry Strategy

async function grammarlyRetry<T>(
  limiter: GrammarlyRateLimiter, fn: () => Promise<Response>, maxRetries = 3
): Promise<T> {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    await limiter.acquire();
    const res = await fn();
    if (res.ok) return res.json();
    if (res.status === 429) {
      const retryAfter = parseInt(res.headers.get("Retry-After") || "20", 10);
      const jitter = Math.random() * 2000;
      await new Promise(r => setTimeout(r, retryAfter * 1000 + jitter));
      continue;
    }
    if (res.status >= 500 && attempt < maxRetries) {
      await new Promise(r => setTimeout(r, Math.pow(2, attempt) * 1500));
      continue;
    }
    throw new Error(`Grammarly API ${res.status}: ${await res.text()}`);
  }
  throw new Error("Max retries exceeded");
}

Batch Processing

async function batchScoreDocuments(documents: string[], batchSize = 8) {
  const results: any[] = [];
  for (let i = 0; i < documents.length; i += batchSize) {
    const batch = documents.slice(i, i + batchSize);
    const batchResults = await Promise.all(
      batch.map(text => grammarlyRetry(scoreLimiter, () =>
        fetch("https://api.grammarly.com/ecosystem/api/v2/scores", {
          method: "POST", headers,
          body: JSON.stringify({ text }),
        })
      ))
    );
    results.push(...batchResults);
    if (i + batchSize < documents.length) await new Promise(r => setTimeout(r, 5000));
  }
  return results;
}

Error Handling

IssueCauseFix
429 on writing scoreExceeded plan-tier per-minute capReduce concurrency, use Retry-After
429 on token refreshMore than 10 refreshes/hourCache token, refresh only on 401
Plagiarism poll timeoutResult not ready after 60sIncrease poll interval to 10s, max 5 min
413 on large documentText exceeds 100K character limitSplit into sections, score individually
Empty score responseText too short for analysisValidate minimum 50 characters before submission

Resources

Next Steps

See grammarly-performance-tuning.

信息
分类 编程开发
名称 grammarly-rate-limits
版本 v20260423
大小 4.66KB
更新时间 2026-04-28
语言