حصة طلبات API

نظرة عامة

يفضل بعض المستخدمين تتبع كمية حصة طلبات API المتبقية لديهم من داخل نفس السكربت أو الخدمة التي تستهلك بيانات أسعار الصرف الخاصة بنا. تُتيح هذه النقطة النهاية ذلك عن طريق إرجاع استجابة بصيغة JSON تُظهر مستوى الحصة لخطتك وعدد الطلبات المتبقية في الفترة الحالية.

يرجى ملاحظة نقطتين هامتين بخصوص هذه النقطة النهاية:

1. هناك تأخير بين إرسال نظامك للطلبات وانعكاسها في عداد الاستخدام الرسمي وحصة الطلبات المتاحة لديك. يعود ذلك إلى حاجة عدة سكربتات مجدولة لجمع عدادات الاستخدام من مختلف أجزاء وبُنى التخزين المؤقت لبنيتنا التحتية. يمكن أن يتراوح التأخير من 5 دقائق إلى 60 دقيقة حسب الظروف.

2. للأسف، يجب أن تُحسب الطلبات المرسلة إلى هذه النقطة النهاية ضمن حصة استخدام طلبات حسابك. كنا نفضل ألا يحدث ذلك، وفي البداية لم يكن الحال كذلك، لكن المستخدمين استمروا في إرسال الطلبات إلى هذه النقطة النهاية في حلقات while(1) مما أدى إلى توليد عشرات الملايين من الطلبات غير الضرورية. تتضمن خطتنا الاحترافية 30 ألف طلب API شهريًا، لذا ستظل قادرًا على مراقبة ذلك بتردد معقول.

وأخيرًا، ملاحظة بخصوص حقل refresh_day_of_month. تُجدد حصص طلبات API في اليوم من الشهر الذي بدأت فيه خطتك الحالية وليس ببساطة في اليوم الأول. وبناءً عليه، تضمن استجابة JSON أيضًا تاريخ كل شهر يتم فيه تخصيص حصة طلبات جديدة لحسابك.

دليل الاستخدام

لاستخدام نقطة نهاية حصة طلبات API الخاصة بنا، ببساطة استبدل مفتاح API الخاص بك ثم أرسل طلب GET إلى الرابط أدناه.

• استبدل YOUR-API-KEY بمفتاح API المعروض في لوحة التحكم الخاصة بك.

GET https://api.currencyexchangerate-api.com/v1/YOUR-API-KEY/quota

سيُرجع هذا الطلب مصفوفة JSON توضح حالة حصة طلبات API الحالية لديك:

{
  "result": "success",
  "plan_quota": 30000,
  "requests_remaining": 25623,
  "refresh_day_of_month": 17
}

استجابات الأخطاء

{
    "result": "error",
    "error-type": "unknown-code"
}

حيث يمكن أن يكون "error-type" هو أي مما يلي:

1. invalid-key: عندما يكون مفتاح API الخاص بك غير صالح.
2. inactive-account: إذا لم يتم تأكيد عنوان بريدك الإلكتروني.
3. quota-reached: عندما يصل حسابك إلى الحد المسموح به من الطلبات وفقًا لخطة اشتراكك.

هل تحتاج إلى مساعدة؟

إذا كان لديك أي أسئلة أو كنت بحاجة إلى المزيد من المساعدة، فلا تتردد في الاتصال بنا. نحن هنا لمساعدتك!