ForHosting KIT · أدوات المطورين

تحليل رؤوس حد الطلبات وحساب وقت إعادة الضبط

تبدو رؤوس تحديد المعدّل بسيطة إلى أن تعبّر الخدمات المختلفة عن وقت إعادة الضبط بطرق متباينة.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

يستقبل هذا المحلّل الحد الأقصى والعدد المتبقي وقيمة إعادة الضبط والوقت الحالي الصريح، ثم يعيد قيما رقمية موحّدة وعدد الثواني الكاملة حتى تتاح الطلبات مجددا. وهو يدعم توقيت Unix بالثواني أو المللي ثانية، وتوقيت UTC الصارم وفق ISO 8601، والإزاحات الرقمية القصيرة. ولأنكم تقدّمون الوقت الحالي، تعطي المدخلات نفسها النتيجة ذاتها في الاختبارات والمتصفح وتكاملات API.

وحّدوا الرؤوس قبل جدولة إعادة المحاولة

تعرض واجهات API عادة الحد الأقصى للطلبات والعدد المتبقي وقيمة إعادة الضبط، لكن على العميل تحويل هذه النصوص إلى قرار آمن. أرسلوا القيم في limit وremaining وreset، وحددوا في current_time لحظة استلام الاستجابة. يتحقق المحلّل من أن limit وremaining عددان صحيحان غير سالبين، ويرفض عددا متبقيا يتجاوز الحد. ويحتفظ بنص reset الأصلي، ويوضح هل فسره كتوقيت مطلق أم إزاحة بالثواني، ويعيد وقت Unix موحّدا. يقرّب الحقل seconds_until_reset إلى الثانية الأعلى كي لا تعيدوا المحاولة خلال الجزء الأخير من فترة الانتظار. وإذا مضى وقت إعادة الضبط تكون المهلة صفرا لا قيمة سالبة. تصلح النتيجة للسجلات وبرمجيات إعادة المحاولة وتأخير قوائم الانتظار وبيانات الاختبار، من دون تكرار القواعد نفسها في كل تكامل.

افهموا كيفية التمييز بين التوقيت والإزاحة

تتبع قيم reset الرقمية أعرافا شائعة. فالقيمة التي تبلغ مليارًا فأكثر تعد ثواني Unix، والتي تبلغ مئة مليار فأكثر تعد مللي ثواني Unix وتحوّل إلى ثوان. أما الأعداد الأصغر غير السالبة فتضاف إلى current_time كإزاحة. لذلك تعمل 30 أو 900 كمهلة، بينما تبقى قيم العصر الحديثة أوقاتا مطلقة. يقبل reset أيضا وقت UTC صارما مثل 2026-07-25T12:01:00Z وفق ISO 8601، مع مللي ثوان اختيارية. تمنع لاحقة UTC افتراض منطقة زمنية. ويقبل current_time الصيغ المطلقة نفسها، لكنه لا يعامل كإزاحة. يكشف التحقق التواريخ المستحيلة والوقت غير الصحيح والقيم المفقودة والأعداد السالبة والنصوص الدخيلة. وتنتج قيمة reset غير القابلة للتحليل خطأ إدخال بدلا من تحويلها خفية إلى صفر، لأن إعادة المحاولة الفورية قد تزيد التقييد وتطيل الانقطاع.

استخدموا نتائج حتمية في العملاء والاختبارات

ينبغي فصل تحليل القيم عن قرارات سياسة إعادة المحاولة. استخدموا هذه الإمكانية لتثبيت معلومات الحصة، ثم دعوا تطبيقكم يقرر الانتظار أو إدراج العمل في قائمة أو خفض التزامن أو عرض رسالة. يُقدَّم current_time صراحة، لذلك لا تغيّر ساعة النظام أو الشبكة أو الإعدادات المحلية أو العشوائية الإجابة. وهكذا تتطابق نتيجة المتصفح مع API وتظل اختبارات الانحدار ثابتة. فإزاحة 60 عند الظهر تماما تعطي دائما توقيتا بعد دقيقة وستين ثانية متبقية. وتعطي أوقات إعادة الضبط السابقة صفرا، وهو مفيد مع Webhook المتأخر أو السجلات المؤرشفة. لا تستنتج الأداة رؤوسا خاصة بمزوّد ولا تختار التراجع الأسي، بل تعالج القيم القياسية المستخرجة. نسخة المتصفح مجانية، وتستخدم استدعاءات API الآلية السعر الأساسي المعروض $0.002 لكل عنصر.

حالات الاستخدام

جدولة إعادة محاولة آمنة

حوّلوا نصوص الرؤوس إلى مهلة بالثواني الكاملة قبل إعادة العمل الفاشل إلى قائمة الانتظار.

تشخيص تقييد المزوّد

وحّدوا الرؤوس الملتقطة وقارنوا وقت إعادة الضبط بلحظة استلام الاستجابة الدقيقة.

إنشاء اختبارات إعادة محاولة حتمية

قدّموا وقتا ثابتا وتحققوا من حسابات مستقرة من دون محاكاة ساعة النظام.

الأسئلة الشائعة

ما تكلفة استدعاء API؟

يستخدم كل عنصر السعر الأساسي المبين وهو $0.002؛ وتنفذ أداة المتصفح الحساب نفسه محليا.

ما صيغ إعادة الضبط المقبولة؟

استخدموا إزاحة غير سالبة بالثواني، أو توقيت Unix بالثواني أو المللي ثانية، أو توقيت UTC صارما وفق ISO 8601 ينتهي بحرف Z.

لماذا يجب تقديم current_time؟

يجعل الوقت الصريح الحساب حتميا والنتائج قابلة للتكرار في العملاء والاختبارات.

ماذا يحدث إذا مضى وقت إعادة الضبط؟

يُقيد seconds_until_reset عند صفر، بينما يحتفظ reset_at_unix بالوقت المطلق الذي جرى تحليله.

هل ترسل الأداة طلبا أو تنتظر؟

لا. فهي تتحقق من قيمكم وتوحّدها فقط، ويبقى تطبيقكم مسؤولا عن سياسة إعادة المحاولة والتراجع.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/security/rate-limit-header-parse

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/security/rate-limit-header-parse \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"100","remaining":"42","reset":"60","current_time":"2026-07-25T12:00:00Z"}'

const res = await fetch("https://api.kit.forhosting.com/security/rate-limit-header-parse", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "limit": "100",
    "remaining": "42",
    "reset": "60",
    "current_time": "2026-07-25T12:00:00Z"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/security/rate-limit-header-parse",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "limit": "100",
    "remaining": "42",
    "reset": "60",
    "current_time": "2026-07-25T12:00:00Z"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/security/rate-limit-header-parse", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"limit":"100","remaining":"42","reset":"60","current_time":"2026-07-25T12:00:00Z"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"limit":"100","remaining":"42","reset":"60","current_time":"2026-07-25T12:00:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/security/rate-limit-header-parse", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "limit": "100",
  "remaining": "42",
  "reset": "60",
  "current_time": "2026-07-25T12:00:00Z"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "security.rate_limit_header_parse",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←