حدود معدل الطلبات

يمكن لكل حساب إجراء 30 طلبًا لإنشاء الروابط في كل نافذة مدتها 60 ثانية، مشتركة بين REST POST /api/v1/links وPOST /api/v1/uploads وPOST /api/v1/sheets وMCP create_links. يستخدم كل حجز رفع وكل إرسال جدول طلبًا واحدًا؛ ولا تستخدم تحويلات الروابط الفرعية أي طلب. ويستخدم كل من الطلب الفوري وإرسال الدفعة طلبًا واحدًا، بصرف النظر عن عدد المدخلات فيه.

تحمل طلبات الإنشاء المقبولة ورفض تجاوز الحد ترويسات منظَّمة:

RateLimit-Policy: "create-links";q=30;w=60
RateLimit: "create-links";r=29;t=60

q هي الحصة وw نافذتها بالثواني. وr عدد الطلبات المتبقية؛ وt عدد الثواني حتى تتحرر خانة. هذه حقول منظَّمة، لا أرقام مجردة.

يؤدي استنفاد الحصة إلى إعادة 429 مع مشكلة rate-limited وRetry-After بالثواني. انتظر قبل إعادة المحاولة، ونسّق بين الجهات التي تستخدم الحساب نفسه. لا تستهلك قراءات المهام حصة إنشاء الروابط هذه؛ اتبع توجيهات poll_after_seconds وRetry-After الخاصة بها.

نافذة البحثنسخ رابط القسم

لـ عمليات البحث بالكلمات المفتاحية نافذة منفصلة لكل حساب تبلغ 30 طلبًا في كل 60 ثانية. لا يستهلك قبول البحث أي خانة من خانات إنشاء الروابط. والروابط الملصقة التي تُحل إلى منتج أو بائع أو جدول أو موقع غير مدعوم تتجاوز البحث بالكلمات المفتاحية ولا تستهلك أيًا من النافذتين؛ أما الروابط الملصقة التي تتعذر قراءتها فقد تصل إلى البحث بالكلمات المفتاحية.

تحمل الاستجابات الناجحة التي تصل إلى مرحلة قبول البحث بالكلمات المفتاحية، وحالات رفض تجاوز حد البحث:

RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60

يُعيد رفض البحث 429 مع search-rate-limited وRetry-After. ولحقول الترويسات المعنى نفسه الموضح أعلاه. وإعادة تشغيل طلب إنشاء باستخدام Idempotency-Key لا تستهلك خانة جديدة من خانات إنشاء الروابط؛ ولا تُخزَّن 429 لإعادة التشغيل.