البدء

حدود المعدّل والحصص

حدود المعدّل لكل مفتاح ولكل عنوان IP، ومستويات الخطط، وكيفية سلوك التقييد.

حدود المعدّل والحصص

تفرض Navvo حدودًا على محورَين — لكل مفتاح API ولكل عنوان IP للعميل — للحفاظ على سرعة المنصة وعدالتها. تُتعقَّب الحدود في نوافذ دقيقة ويومية متدحرجة.

الحدود الافتراضية

الحدّ	الافتراضي	ينطبق على
لكل مفتاح، في الدقيقة	180 طلبًا	كل مفتاح API (`quotaPerMinute`).
لكل مفتاح، في اليوم	2,500 طلب	كل مفتاح API (`quotaPerDay`).
لكل IP، في الدقيقة	90 طلبًا	عنوان IP المصدر.
لكل IP، في اليوم	30,000 طلب	عنوان IP المصدر.

الحدود لكل مفتاح قابلة للتهيئة عند إنشاء المفتاح (quotaPerMinute / quotaPerDay) ويمكن رفعها في الخطط الأعلى. أما الحدود لكل IP فهي ضوابط حماية على مستوى المنصة بأكملها تنطبق بغضّ النظر عن المفتاح.

الخطط

تحمل المفاتيح مستوى خطّة يحدّد الحصّة المتاحة:

الخطّة	مخصّصة لـ
`free`	النماذج الأوّلية والتطبيقات منخفضة الحجم.
`startup`	تطبيقات الإنتاج ذات حركة المرور المعتدلة.
`growth`	أعباء الإنتاج عالية الحجم.
`enterprise`	حدود مخصّصة ودعم مكرّس.

هل تحتاج إلى إنتاجية أعلى؟ اضبط quotaPerMinute / quotaPerDay عند إنشاء المفتاح (راجع المصادقة)، أو تواصل مع Navvo للانتقال إلى خطّة growth/enterprise.

عند تجاوزك لحدّ ما

تُرفَض الطلبات التي تتجاوز أي حدّ بالحالة HTTP 403 مع رسالة وصفية، على سبيل المثال:

{
  "statusCode": 403,
  "message": "API key quota exceeded for scope routing: 180/minute",
  "error": "Forbidden"
}

رسائل تقييد أخرى قد تراها: ... 2500/day، وIP rate limit exceeded، وIP daily quota exceeded.

أفضل الممارسات

خزّن مؤقتًا بكثافة

نادرًا ما تتغيّر البلاطات والأنماط وتفاصيل الأماكن من دقيقة لأخرى. احترم ترويسات Cache-Control وخزّن الاستجابات مؤقتًا حيثما أمكن.

ادمج الطلبات حيثما أمكن

استخدم نقطة نهاية المصفوفة بدلًا من N استدعاء مسار منفصل، واطلب بيانات خريطة محدودة باستخدام bbox/تغطية البلاطات.

أبقِ المفاتيح على الخادم

مرّر الطلبات عبر خادمك الخلفي حيثما أمكن، حتى لا يتضاعف مفتاح مشترك واحد عبر عناوين IP متعدّدة للعملاء.

تراجع عند 403

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

تُحسَب الحصص لكل طلب، عبر جميع النطاقات التي استخدمها ذلك المفتاح ضمن النافذة. تُحسَب عمليات القراءة والكتابة كلتاهما.

المصادقة

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

الأخطاء ورموز الحالة

رموز حالة HTTP، وأشكال استجابات الأخطاء، وغلاف توفّر المحرّك.