نظرة عامة على الحصة
تحقق من السعة قبل بدء المعالجة
استخدم endpoint الرصيد المتبقي من مهام المراقبة أو لوحات التحكم الداخلية أو عمليات الدفعات. يعيد استجابة مختصرة من دون إجراء بحث لتحديد الجنس.
الأرصدة المتبقية9,443طلبات متاحة
حالة الباقة نشطةوفق الاستجابة التوضيحية
تنتهي في1752651601UNIX timestamp
GET
endpoint الرصيد المتبقي
استرجع معلومات الحصة
أضف مفتاح API في معامل الاستعلام key. نفّذ الطلب من جهة الخادم حتى لا تنكشف بيانات الاعتماد للزوار.
https://api.genderapi.io/api/remaining?key=YOUR_API_KEYcURL
curl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"حماية بيانات الاعتماد: لا تستدعِ هذا endpoint مباشرةً من JavaScript عام داخل المتصفح. شغّله من backend أو مهمة مجدولة أو دالة خادم محمية.
استجابة توضيحية
الرصيد ووقت الانتهاء
JSON
{
"status": true,
"remaining": 9443,
"expiresAt": 1752651601
}حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
status | boolean | true عندما ينجح الطلب ويكون مفتاح API صالحاً. |
remaining | integer | عدد أرصدة API المتاحة حالياً. |
expiresAt | integer | وقت انتهاء الباقة بصيغة UNIX timestamp بالثواني. |
إرشادات التشغيل
أنشئ مراقبة للحصة تتصرف مبكراً
اعرض السعة الحالية
اعرض الرصيد في لوحة تحكم داخلية لفرق التشغيل والدعم.
حدد حدوداً للتنبيه
أرسل تنبيهاً قبل وصول الرصيد إلى الصفر لإتاحة وقت لإضافة أرصدة.
احمِ عمليات الدفعات
قارن الأرصدة المتاحة بحجم الدفعة المخطط لها قبل بدء المهمة.
مثال على سياسة التنبيه
استخدم حدوداً تناسب حركة المرور لديك بدلاً من رقم موحد للجميع.
- جيدأكثر من 20% متبقٍ
- تحذيرمتبقٍ بين 10 و20%
- حرجأقل من 10% متبقٍ
خطط لاحتمال نفاد الحصة
لا تنتظر ظهور خطأ API لاكتشاف نفاد الرصيد. راقب الحصة بجدول زمني مناسب، وتجنب التحقق قبل كل عملية بحث منفردة، وحدد كيف يوقف تطبيقك العمل أو يعيد المحاولة.
المرجع التالي