ما هو
قارئ مجاني لترويسات حدود المعدّل. يفهم Retry After وعائلة X RateLimit وحقول IETF RateLimit والصيغ التي تستخدمها GitHub وOpenAI وAnthropic وShopify وDiscord.
الرمز 429 بكلمات بسيطة
ردّت واجهتك البرمجية بالرمز 429، وإليك ما كانت تقصده فعلًا.
الصق ترويسات الاستجابة. يقرأ Rate Limit Story الحد والمتبقي ووقت إعادة الضبط ومدة الانتظار، ثم يكتب قصة من أربعة مشاهد وردًّا جاهزًا للعميل الذي اصطدم بالجدار.
- العميل
أُرسل الدفعة 501 من 600…
- الواجهة
طلبات كثيرة جدًا! دلو الرموز فارغ.
- Rate Limit Story
انتظر 20 ث ثم أعد المحاولة مع تأخير عشوائي صغير.
لمن هو
لأصحاب الواجهات البرمجية وفرق دعم المطورين ومديري الشركاء، ولكل من أرسل له عميل لقطة شاشة لخطأ 429 بلا أي سياق.
ما المشكلة التي يحلها
ترويسات حدود المعدّل غامضة، تخلط وقت Unix بالثواني وتختلف من مزوّد لآخر. فيخمّن الناس ويعيدون المحاولة بسرعة ويُحظرون مدة أطول.
احكِ قصة استجابة
كل شيء يُقرأ داخل هذا التبويب. لا يُرفع أي شيء تلصقه ولا يُحفظ.
حمّل عيّنة
الصق الترويسات الخام أو مخرجات curl -i أو كائن JSON من الترويسات. سطر الحالة اختياري.لا توجد قصة بعد
الصق ترويسات طلب فاشل أو حمّل إحدى العيّنات.
لا تغادر الترويسات هذه الصفحة. ومع ذلك احذف ترويسات التفويض وملفات تعريف الارتباط قبل مشاركة أي لقطة شاشة.
الترويسات التي يفهمها
يمكنك خلط ترويسات بأساليب مختلفة في لصقة واحدة. لا يهم حجم الأحرف في الأسماء.
Retry After
Retry-After: 20ثوانٍ أو تاريخ HTTP. إن وُجد فهو مقدَّم على أي تلميح آخر لإعادة الضبط.
عائلة X RateLimit
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1792661820تستخدمها GitHub وواجهات بأسلوب Twitter وغيرها كثير. قد تكون قيمة إعادة الضبط ثواني Unix أو مللي ثوانيه أو ثواني من الآن، والأداة تخبرك بما اختارت.
IETF RateLimit
RateLimit-Policy: "default";q=100;w=60
RateLimit: "default";r=7;t=42الحقول القياسية التي تحمل الحصة والنافذة والمتبقي والوقت حتى إعادة الضبط.
OpenAI وAnthropic
x-ratelimit-remaining-tokens: 0
x-ratelimit-reset-tokens: 18.4sدلاء منفصلة للطلبات والرموز بمدد مثل 6m0s. يُعلَّم الدلو الفارغ على أنه الذي يوقفك.
Shopify وDiscord
X-Shopify-Shop-Api-Call-Limit: 38/40
X-RateLimit-Reset-After: 2.75عدّادات المستخدم من السعة، وإعادة الضبط بعد ثوانٍ، والدلاء والنطاقات والحدود العامة.
طريقة الاستخدام
انسخ الترويسات
من تبويب الشبكة في المتصفح أو من curl -i أو من سجلاتك أو من لقطة الشاشة التي أرسلها العميل. المهم أسطر الترويسات فقط.
الصقها واحكِ القصة
يُقرأ كل دلو على حدة، ويصبح الدلو الفارغ أو الأقرب إلى الفراغ بطل القصة.
اقرأ المشاهد الأربعة
ماذا حدث وأين تقف ومتى يُعاد الضبط وماذا تفعل، مع الأوقات بتوقيت UTC وبمنطقتك الزمنية.
أرسل الرد
انسخ الرد الجاهز إلى التذكرة، أو انسخ القصة كاملة لملاحظاتك.
من المفيد أن تعرف
- الأداة تشرح الترويسات التي تلصقها فقط. لا تتصل بالواجهة ولا ترى الحدود التي تحتفظ بها الواجهة لنفسها.
- عندما تكون قيمة إعادة الضبط ملتبسة، تُعامل الأرقام الأكبر من مليار كوقت Unix والأصغر كثوانٍ.
- الوتيرة الآمنة تحتاج إلى الحد وطول النافذة معًا. كثير من الواجهات ترسل الحد فقط.
- الأوقات بمنطقتك الزمنية تعتمد على ساعة هذا الجهاز.
أسئلة
لماذا ترسل GitHub الرمز 403 بدل 429؟
تردّ GitHub على بعض الطلبات المحدودة بالرمز 403. وتعدّها القصة محدودة ما دام المتبقي صفرًا.
أيهما يُعتمد، Retry After أم وقت إعادة الضبط؟
Retry After. فهو الخادم يخبرك بالضبط كم تنتظر، بينما يصف وقت إعادة الضبط النافذة كلها.
ما التأخير العشوائي ولماذا نضيفه؟
انتظار إضافي صغير وعشوائي. من دونه يعيد كل العملاء المحظورين المحاولة في الثانية نفسها فيصطدمون بالحد مجددًا.
هل لصق ترويسات حقيقية آمن؟
الصفحة لا ترسل أي شيء إلى أي مكان. ومع ذلك احذف ترويسات Authorization وملفات تعريف الارتباط قبل أن تشارك شيئًا.