رفتن به محتوا
مستندات API سلر ۳۶۰

سقف درخواست

سقف هر کلید

Section titled “سقف هر کلید”
نوع درخواست سقف در هر دقیقه
خواندن (GET) 120
تغییر (POST، PUT، PATCH، DELETE) 30

خواندن و تغییر جدا شمرده می‌شوند؛ خواندن‌های زیاد هرگز جلوی ثبت فروش را نمی‌گیرد. سقف‌های هر کلید در پاسخ GET /v1/me هم آمده است.

سرآیندها

Section titled “سرآیندها”

هر پاسخ X-RateLimit-Limit، X-RateLimit-Remaining و X-RateLimit-Reset دارد. اگر سقف پر شود، پاسخ 429 با خطای rate_limited و سرآیند Retry-After برمی‌گردد.

HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1762930020

رفتار درست

Section titled “رفتار درست”
  1. پیش از رسیدن به سقف، X-RateLimit-Remaining را ببینید و سرعت را کم کنید.
  2. در پاسخ 429، دقیقا به اندازه‌ی Retry-After صبر کنید و بعد همان درخواست را (برای تغییرها با همان Idempotency-Key) دوباره بفرستید.
  3. به جای خواندن پیاپی، وب‌هوک دریافت کنید.

سقف‌های دیجی‌کالا

Section titled “سقف‌های دیجی‌کالا”

تغییرها در نهایت به دیجی‌کالا می‌رسند و دیجی‌کالا برای هر فروشنده سقف‌های خودش را دارد؛ مثلا پایه‌ی اعلام‌شده‌ی نوشتن ۲۰۰ درخواست در ساعت برای هر مسیر است که بر اساس فعالیت فروشنده بیشتر می‌شود. اگر سقف دیجی‌کالا پر شود، پاسخ 503 با خطای digikala_rate_limited و Retry-After برمی‌گردد و هیچ تغییری انجام نمی‌شود.