الاستخدام والحصة

تتيح لك منصة GenderAPI التحقق من رصيد رصيد حسابك الحالي في أي وقت من خلال نقطة نهاية مخصصة. يساعدك ذلك على مراقبة استخدامك وتجنب الانقطاعات غير المتوقعة عند تشغيل عمليات ذات حجم كبير.

✅ التحقق من الرصيد المتبقي

يمكنك الحصول على معلومات حصتك الحالية باستخدام نقطة النهاية التالية:

GET https://api.genderapi.io/api/remaining?key=YOUR_API_KEY

مثال على طلب باستخدام curl:

curl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"

✅ مثال على الاستجابة

تعيد واجهة API كائن JSON:

{
  "status": true,
  "remaining": 9443,
  "expiresAt": 1752651601
}

حقول الاستجابة

الحقل النوع الوصف
status Boolean يشير إلى ما إذا كانت الطلبية ناجحة. يعيد true إذا كان مفتاح API الخاص بك صالحًا.
remaining Integer عدد أرصدة API المتبقية في حسابك.
expiresAt Integer (timestamp) تاريخ انتهاء صلاحية حزمة الرصيد الحالية كطابع زمني يونكس.

حالات الاستخدام

  • عرض معلومات الحصة الحالية في واجهة لوحة التحكم الخاصة بك.
  • إطلاق تنبيهات عندما ينخفض رصيدك إلى ما دون حد معين.
  • الاندماج مع أدوات الفوترة أو المراقبة لتجنب انقطاع الخدمة.
هام: تأكد دائمًا من متابعة رصيدك المتبقي لتجنب الأخطاء غير المتوقعة بسبب نفاد الحصة. يجب على البرامج النصية ذات الحجم الكبير أو المؤتمتة التحقق من حصتك بشكل دوري.