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

فهم حدود استخدام API وإدارة الحصص.

نظرة عامة

يستخدم API Kantesti نظام حصص قائم على الرصيد. كل طلب إنتاج ناجح يستهلك رصيدًا واحدًا من حصة حسابك.

وضع Sandbox

نقاط نهاية sandbox مجانية ولا تستهلك حصة. استخدمها من أجل:

• التطوير - بناء واختبار تكاملك
• الاختبار - التحقق من معالجة الطلبات/الاستجابات
• العروض التوضيحية - إظهار قدرات API دون تكلفة

التحقق من الحصة

استخدم نقطة نهاية التحقق من الحصة لمراقبة الرصيد المتبقي:

curl -X POST "https://app.aibloodtestinterpret.com/api/quota/check" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "اسم_المستخدم",
    "password": "كلمة_المرور"
  }'

الاستجابة

{
  "status": "success",
  "data": {
    "username": "اسم_المستخدم",
    "remaining_quota": 150,
    "timestamp": "2025-12-22T10:30:00Z"
  }
}

عندما تنفد الحصة

عندما تنفد حصتك، يُرجع API خطأ QUOTA_1101:

{
  "status": "error",
  "error": {
    "code": "QUOTA_1101",
    "message": "حصة API غير كافية",
    "details": "الحصة الحالية: 0. قم بزيارة موقعنا لشراء المزيد من الرصيد.",
    "timestamp": "2025-12-22T10:30:00Z"
  }
}

أفضل الممارسات

تحسين استخدام الحصة

• استخدم sandbox للتطوير - انتقل إلى الإنتاج فقط عندما تكون جاهزًا
• ادمج رفع الفحوصات - ادمج صفحات متعددة في ملف PDF واحد
• قم بتخزين النتائج مؤقتًا - احفظ نتائج التحليل لتجنب إعادة المعالجة
• راقب الاستخدام - تحقق من الحصة المتبقية بانتظام

معالجة أخطاء الحصة

async function analyzeWithQuotaCheck(file) {
  // تحقق من الحصة قبل إجراء الطلب
  const quotaResponse = await checkQuota();

  if (quotaResponse.data.remaining_quota < 1) {
    throw new Error('لا توجد حصة متبقية. يرجى شراء المزيد من الرصيد.');
  }

  // تابع التحليل
  return await analyzeBloodTest(file);
}

async function checkQuota() {
  const response = await fetch('/api/quota/check', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ username, password })
  });
  return response.json();
}

خطط المؤسسات

للاستخدام بكميات كبيرة، اتصل بنا للحصول على خطط المؤسسات مع:

• حدود حصة أعلى
• خصومات على الحجم
• دعم ذو أولوية
• اتفاقيات مستوى خدمة مخصصة
• بنية تحتية مخصصة

الاتصال: [email protected]