موتيميت: هل هناك أي حدود لاستخدام واجهة برمجة التطبيقات العامة؟

حد المعدل

تعمل واجهة برمجة التطبيقات API بمعدل 1200 طلب في كل 10 دقائق. هذا يعني أنه يمكنك إرسال طلبين كحد أقصى في الثانية خلال أي فترة 10 دقائق. لاحظ أن هذا الحد مشترك بين جميع نقاط النهاية لدينا، بدلاً من احتسابه في نقاط النهاية الفردية.

إذا قمت بتجاوز هذا الحد، ستتلقى ردًا برقم 429 طلبات كثيرة جدًا.

تتوفر حالة حد المعدل الحالي في رأس RateLimit.

مثال على ذلك:

معدل الحد: الحد=1200، المتبقي=956، إعادة تعيين=543

انظر مسودة IETF لمزيد من التفاصيل.

إذا واجهتك مشكلة في الوصول إلى هذا الحد، يُرجى إدخال فترة تأخير بين الطلبات للوصول إلى أقل من الحد مرة أخرى.

عوامل التصفية / حجج المسار

هناك حد 50 وسيطة (أي معرّفات المستخدم) لكل مكالمة عند التصفية باستخدام وسيطات المسار.

ترقيم الصفحات

الحد الأقصى للنتائج في كل صفحة هو 50. استخدم معلمات استعلام الصفحة وكل_صفحة لجلب نتائج إضافية.

 

مثال على ذلك:

/المستخدمون؟ الصفحة=3&لكل_صفحة=30

كيفية جلب جميع البيانات من واجهة برمجة التطبيقات مع حدود ترقيم الصفحات؟
ملاحظة: يستخدم هذا المثال GET /groups، ولكن يمكنك تكرار الخطوات مع نقاط نهاية أخرى.

1.  

   1. جلب جميع البيانات:

      بالنسبة إلى i في {1..NUMBER_OF_PAGES}؛ افعل
      
          curl -X GET "https://motimateapp.com/public_api/groups?page=$i"
      
          تم

   2. قم بتخزين البيانات على جهازك.
       

   3. اجلب فقط الموارد التي تم تحديثها أو إنشاؤها بعد آخر عملية جلب (على سبيل المثال قبل يوم واحد) وادمجها مع البيانات التي لديك بالفعل:

      
        curl -X GET "https://motimateapp.com/public_api/groups?filter [تم إنشاؤه_في_وقت_ما] =<ONE_DAY_AGO>"
      
        curl -X GET "https://motimateapp.com/public_api/groups?filter [تم تحديثه_في_وقت_ما] =<ONE_DAY_AGO>"
      
        

   4. كلما قمت بتنفيذ طلب حذف، قم بإزالة المورد من نسختك.
       
   5. قم بإجراء إعادة المزامنة بشكل دوري (أسبوعيًا على سبيل المثال) عن طريق جلب جميع البيانات مرة أخرى وتحديث نسختك.