Batas permintaan
Batas permintaan per paket untuk Listings dan Social, struktur respons 429, serta cara menunda dan mencoba kembali.
Listings API menghitung permintaan per akun berdasarkan batas laju permintaan paket Anda. Mematuhi batas ini menjaga integrasi Anda tetap responsif; jika batas terlampaui, API mengembalikan 429 Too Many Requests beserta semua informasi yang Anda perlukan untuk mencoba kembali dengan tepat.
Batas per paket
Mencoba API tanpa paket berbayar? Akses harian sandbox gratis mengembalikan batas permintaan yang berlaku beserta kunci API saat Anda memulai akses harian.
Batas ditentukan berdasarkan paket dan diterapkan per akun: setiap kunci API dalam satu akun menggunakan kuota yang sama. Permintaan dihitung dalam tiga rentang waktu: batas lonjakan per menit, batas per jam, dan batas harian. Setiap permintaan menghabiskan kuota yang sama, apa pun endpoint-nya. Uji coba gratis menggunakan paket yang Anda pilih, sehingga batas paket tersebut berlaku sejak permintaan pertama.
Social menggunakan kuota yang sama
Permintaan ke endpoint Social dihitung dalam kuota permintaan per akun yang sama dengan semua permintaan lainnya. Satu POST /social/bulk-posts yang memuat 500 baris menghabiskan kuota satu permintaan, bukan 500, sehingga pemuatan secara massal merupakan cara paling hemat untuk memuat banyak konten.
Listings dan Social merupakan langganan terpisah, tetapi kuotanya tidak terpisah. Akun yang berlangganan keduanya mendapatkan batas yang lebih tinggi dari kedua tingkat paket, yang diterapkan satu kali untuk seluruh endpoint — bukan jumlah keduanya, dan bukan satu kuota per produk. Semua permintaan pelanggan yang menggunakan Listings Launch dan Social Growth dihitung berdasarkan batas Growth di atas.
Respons 429
Saat Anda melampaui batas, API mengembalikan HTTP 429 beserta respons kesalahan standar. Tiga field berikut penting untuk percobaan ulang:
retry_after_seconds: berapa lama Anda harus menunggu sebelum mencoba kembali. Header HTTPRetry-Aftermemuat nilai yang sama jika tersedia.correlation_id: pengenal permintaan yang perlu Anda sertakan saat menghubungi dukungan.doc_url: tautan kembali ke entrirate_limiteddalam referensi kode kesalahan.
{ "error": { "code": "RATE_LIMITED", "message": "Too many requests. Slow down.", "retry_after_seconds": 30, "correlation_id": "9f2c1e64-2b1a-4b0e-9f1a-2c7d5e8a1b3c", "doc_url": "https://listingsapi.com/docs/error-codes#rate_limited" }}Menangani respons 429 dengan jeda percobaan ulang
Ikuti retry_after_seconds jika tersedia; jika tidak, tingkatkan jeda secara eksponensial: gandakan jeda pada setiap 429 yang diterima berturut-turut hingga mencapai batas maksimum, dengan sedikit variasi acak agar sekumpulan klien tidak mencoba kembali secara bersamaan.
import randomimport time import requests MAX_RETRIES = 5 def get_with_backoff(url: str, headers: dict, max_retries: int = MAX_RETRIES): for attempt in range(max_retries): resp = requests.get(url, headers=headers) if resp.status_code != 429: resp.raise_for_status() return resp.json() # Prefer the server's hint; fall back to exponential backoff + jitter. body = resp.json().get("error", {}) retry_after = body.get("retry_after_seconds") if retry_after is None: retry_after = min(2 ** attempt, 30) + random.uniform(0, 1) time.sleep(retry_after) raise RuntimeError("Still rate limited after retrying")Menjaga penggunaan di bawah batas
-
Jangan memeriksa status listings scan lebih sering dari sekali setiap 15 detik, dan utamakan webhook
listing_scan.completed, yang mengirimkan hasil pemindaian yang sudah selesai tanpa perlu memeriksa status secara berkala. Pemindaian memerlukan waktu beberapa menit, sehingga perulangan yang lebih cepat hanya menghabiskan kuota permintaan. -
Minta satu halaman pada satu waktu: perulangan paginasi paralel dengan jeda yang sangat singkat merupakan penyebab paling umum respons
429. BacapageInfo.hasNextPagedan ambil halaman berikutnya hanya setelah respons untuk halaman saat ini diterima. -
Lakukan pemfilteran di sisi server dengan parameter kueri
filter, alih-alih mengambil semua halaman lalu membuang baris di sisi klien. -
Simpan respons yang jarang berubah dalam cache, alih-alih mengambilnya kembali pada setiap permintaan.