ℹ️ معلومة — هذه الحدود تخصّ الواجهة البرمجية وحدها — ولا تمسّ متجرك أبدًا

كل ما في هذه الصفحة يحتسب الطلبات المُرسَلة بمفتاح API إلى https://api.dzbuild.app/v1.

أما واجهة متجرك، وعملاؤك أثناء إتمام الطلب، ولوحة التحكم، وتطبيق الهاتف، وكل ميزة مدمجة في المنصة، فلا تتأثر إطلاقًا. فهي لا تستهلك هذه الحصة، ولا تُقيَّد بها أبدًا، وحصولك على 429 هنا ليس له أي أثر على بقاء متجرك مفتوحًا ومستقبلًا للطلبات.

وإن لم تُنشئ مفتاح API قط، فلا شيء في هذه الصفحة ينطبق عليك.

يُطبَّق الحد لكل دقيقة لكل متجر — فجميع مفاتيح المتجر الواحد تتشارك ميزانية واحدة، وإنشاء مفاتيح إضافية لا يرفع السقف أبدًا. ويعمل ضمن نافذة ثابتة مدتها 60 ثانية: يُصفَّر العدّاد مع كل دقيقة من ساعة الحائط. ولأن النافذة ثابتة لا منزلقة، فقد تمرّ لوهلة دفعةٌ تقع على حدّ الدقيقة بأكثر من السقف. تعامل مع 429 بحذر بدل ضبط وتيرتك تمامًا على الحد.

الواجهة البرمجية متاحة على خطة Enterprise وحدها. لا تُصدَر المفاتيح إلا لمتاجر Enterprise، وأي مفتاح يغادر متجرُه خطة Enterprise — بتخفيض الخطة أو بانتهاء صلاحية الاشتراك — يحصل على 403 forbidden (برسالة API access requires an active Enterprise plan) في كل نداء. ولا شيء يحتاج إلى إعادة إصدار: يعود المفتاح نفسه إلى العمل لحظة عودة المتجر إلى خطة Enterprise سارية.

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

ولا وجود لسقف شهري: لا يقيّد الاستعمالَ إلا السقف في الدقيقة، ما لم يضبط الدعم تجاوزًا خاصًا بالمتجر يتضمّن مخصّصًا شهريًا صريحًا (انظر الحصص).

بعض النقاط تؤدي في النداء الواحد عملًا أثقل بكثير من عملية قراءة عادية: فهي تنزّل الملفات وتعيد ترميزها، أو تُطلق مهامًا في الخلفية. ولهذه النقاط ميزانية ثانية أصغر لكل متجر، فوق الحد لكل دقيقة أعلاه:

تجاوز الشق الخاص بالدقيقة يُرجع 429 rate_limited؛ أما تجاوز شق التوازي فيُرجع 429 too_many_concurrent، ومعناه ببساطة "أعد المحاولة بعد ثوانٍ" — فثمة نداء سابق لم ينتهِ بعد.

وهذه الحدود ضيّقة عن قصد. فإضافة معرض صور منتج كامل تبقى دون الدقيقة بكثير، والسقف يمنع تكاملًا واحدًا من إبطاء الخوادم التي تخدم واجهة متجرك أيضًا.

ويزيد العدّاد الشهري مرة واحدة عن كل طلب موثَّق لا يُخدَم من الذاكرة المؤقتة — طلبات GET المخدومة من الذاكرة المؤقتة و/v1/ping مجانية، والطلبات الفاشلة تُحتسب رغم ذلك.

استدعِ GET /v1/quotas (انظر الحصص) لقراءة الحدود المسجَّلة حاليًا لمتجرك، بما فيها أي تجاوز طبّقه الدعم على حسابك.

ويمكن لتجاوز خاص بالمتجر أن يرفع مخصّصاتك دون تغيير خطتك. وإن كنت تبني شيئًا يحتاج فعلًا إلى إنتاجية أعلى ومستدامة، فتواصل مع الدعم واشرح له نمط الطلبات المتوقَّع.