Hız sınırları

Anahtar başına dakikada 300 istek; başlıklar ve 429 yanıtı.

Her API anahtarı dakikada en fazla 300 istek yapabilir. Sınır anahtar başınadır: aynı hesaptaki başka bir anahtar kendi sınırını kullanır.

Yanıt başlıkları

Başlık	Anlamı
`X-RateLimit-Limit`	Dakikalık sınır (300).
`X-RateLimit-Remaining`	Bu pencerede kalan istek sayısı.
`Retry-After`	Yalnız 429 ve 503 yanıtlarında: kaç saniye sonra yeniden denenmeli.

Sınır aşılınca

Sınır aşılırsa API 429 Too Many Requests ve RATE_LIMITED koduyla döner. Retry-After kadar bekleyip yeniden deneyin.

retry.js

async function haizora(path, init = {}, attempt = 0) {
  const res = await fetch(`https://api.haizora.com/v1${path}`, {
    ...init,
    headers: { Authorization: `Bearer ${process.env.HAIZORA_TOKEN}`, ...init.headers },
  });
  if ((res.status === 429 || res.status === 503) && attempt < 3) {
    const wait = Number(res.headers.get("Retry-After") ?? 1);
    await new Promise((r) => setTimeout(r, wait * 1000));
    return haizora(path, init, attempt + 1);
  }
  return res;
}

Liste uçlarını sık sık yoklamak yerine sonucu kısa süre önbelleğe alın; değişiklik yapan istekleri sıraya koyun.