Rate limit

Tebar membatasi request di dua lapis:

1. Batas umum per menit untuk semua request lewat API key atau token OAuth.
2. Batas per fitur untuk aksi yang mahal atau rawan disalahgunakan, misalnya sinkronisasi dan upload.

Platform sosial juga punya batasnya sendiri, misalnya jumlah post per hari. Batas itu tidak diatur Tebar (lihat Batas dari platform).

Batas umumSalin link

Batas umum menghitung semua request dari API key dan token OAuth milik satu akun Tebar, REST API dan MCP digabung. Dashboard tidak ikut dihitung.

Batas = 60 request per menit + 5 untuk setiap akun sosial aktif, maksimal 600.

Hitungannya per jendela 1 menit. Semua API key milik akun yang sama berbagi satu hitungan, jadi membuat key baru tidak menambah batas. Jumlah post tidak dibatasi oleh Tebar; batasnya hanya kuota paket dan aturan platform.

Header di setiap responsSalin link

Pakai RateLimit-Remaining untuk memperlambat sebelum batas habis, misalnya saat memproses antrean besar.

Saat batas terlampauiSalin link

API membalas 429 Too Many Requests dengan header Retry-After (detik) dan body:

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 65 a minute for this account. Try again in 23 seconds.",
    "details": { "retry_after_seconds": 23, "limit": 65 }
  }
}

Tunggu selama Retry-After, lalu kirim ulang request yang sama. Request yang ditolak dengan 429 tidak diproses sama sekali, jadi aman dikirim ulang. Untuk POST /v1/posts, tetap sertakan Idempotency-Key yang sama supaya post tidak terbit dua kali bila jawaban sebelumnya hilang di jalan.

async function tebar(path, init = {}, tries = 3) {
  const res = await fetch(`https://api.tebar.app/v1${path}`, {
    ...init,
    headers: { Authorization: `Bearer ${process.env.TEBAR_API_KEY}`, ...init.headers },
  });
  if (res.status === 429 && tries > 1) {
    const wait = Number(res.headers.get('Retry-After') ?? 5);
    await new Promise((r) => setTimeout(r, wait * 1000));
    return tebar(path, init, tries - 1);
  }
  return res;
}

Di n8n, nyalakan Retry On Fail di node HTTP Request dan beri jeda (Wait Between Tries) minimal 5 detik.

MCPSalin link

Tool MCP berbagi batas umum yang sama dengan REST API. Saat batas terlampaui, endpoint /mcp membalas HTTP 429 dengan header Retry-After dan body { "error": "rate_limited", "error_description": "…" }. Batas per fitur di dalam tool muncul sebagai pesan error dari tool itu, dan agent AI bisa mencoba lagi setelah menunggu. Pengecualian: list_comments dengan refresh: true tidak error saat batas sinkronisasinya habis; komentar yang sudah tersimpan tetap dikembalikan tanpa membaca ulang dari platform.

Batas per fiturSalin link

Batas ini berlaku selain batas umum dan dihitung per akun Tebar, kecuali disebut lain. Saat terlampaui, jawabannya juga 429 rate_limited; details.retry_after_seconds berisi waktu tunggu paling lama (panjang jendelanya).

Sinkronisasi tidak perlu dipanggil terus-menerus: komentar, DM, dan insight sudah diperbarui otomatis di belakang. Untuk tahu kapan ada komentar baru, pakai webhook keluar daripada polling.

Batas dari platformSalin link

Setiap platform membatasi jumlah post per akun per hari dan jumlah panggilan API-nya sendiri. Batas ini berlaku untuk akun sosialnya, tidak bisa dinaikkan Tebar, dan ikut terpakai oleh post yang dibuat di aplikasi platform atau alat lain.

• Cek sisa kuota posting dengan GET /accounts/{id}/publishing-limit sebelum mengirim banyak post.
• Bila platform menolak karena batasnya, target post gagal dengan error_code seperti publish_limit_reached atau rate_limited (lihat Error). Kalau waktu reset-nya diketahui, target tetap pending dan retry_after berisi waktu percobaan berikutnya.