الانتقال إلى المحتوى

الحدود

معدلات الطلبات والحصص وقواعد المعاملات في البيئة التجريبية.

معدل الطلبات

يستطيع كل مشروع تجريبي إرسال 60 طلبًا في الدقيقة و5.000 طلب في اليوم. تتقاسم جميع مفاتيحه هذه الحدود: إنشاء مفاتيح أخرى لا يزيد المعدل.

  • عند تجاوزها، تعيد الواجهة 429 rate_limited مع الترويسة Retry-After.
  • لا يُحتسب في الاستخدام الطلب المرفوض بسبب تجاوز الحد.
  • هذه القيم مؤقتة وقد تتغير خلال النسخة التجريبية.

حدود وحدة التحكم

  • 5 مفاتيح نشطة على الأكثر لكل مشروع.
  • 10 عمليات إنشاء مفاتيح في الساعة لكل حساب.
  • 20 مشروعًا غير مؤرشف على الأكثر لكل مؤسسة.
  • 10 عمليات إنشاء مشاريع في الساعة لكل حساب.

قواعد المعاملات

يتلقى الطلب الخارج عن هذه القواعد 422 validation_failed.

قواعد المعاملات
المسارالمعاملالقواعد
/v1/localities/searchq
  • 1.024 بايت UTF-8 على الأكثر
  • حرف أو رقم واحد على الأقل
/v1/localities/searchlang
  • القيم: fr، ar
  • القيمة الافتراضية: fr
/v1/localities/searchlimit
  • من 1 إلى 20
  • القيمة الافتراضية: 10
/v1/places/searchq
  • 1.024 بايت UTF-8 على الأكثر
  • 2 من الأحرف أو الأرقام على الأقل
/v1/places/searchlang
  • القيم: fr، ar
  • القيمة الافتراضية: fr
/v1/places/searchcategories
  • القيم: healthcare، shopping، food، education، administration، transport، worship، accommodation
  • مفصولة بفواصل، كل قيمة مرة واحدة
  • 200 حرف على الأكثر
/v1/places/searchnear
  • longitude,latitude بنظام WGS84
/v1/places/searchlimit
  • من 1 إلى 20
  • القيمة الافتراضية: 10
/v1/placesbbox
  • west,south,east,north بنظام WGS84، و2° على الأكثر لكل ضلع
/v1/placescategories
  • القيم: healthcare، shopping، food، education، administration، transport، worship، accommodation
  • مفصولة بفواصل، كل قيمة مرة واحدة
  • 200 حرف على الأكثر
/v1/placeslang
  • القيم: fr، ar
  • القيمة الافتراضية: fr
/v1/placeslimit
  • من 1 إلى 500
  • القيمة الافتراضية: 200
/v1/places/osm/{type}/{id}type
  • القيم: node، way
/v1/places/osm/{type}/{id}id
  • عدد صحيح موجب من 20 رقمًا على الأكثر
/v1/places/osm/{type}/{id}lang
  • القيم: fr، ar
  • القيمة الافتراضية: fr