מגבלות שימוש

הבן מגבלות שימוש API וניהול מכסות.

סקירה כללית

Kantesti API משתמש במערכת מכסות מבוססת קרדיטים. כל בקשת ייצור מוצלחת צורכת קרדיט אחד ממכסת החשבון שלך.

מערכת מכסות
בקשות ייצורקרדיט אחד לכל בקשה מוצלחת
בקשות sandboxחינם (אין צריכת מכסה)
בקשות כושלותאין צריכת מכסה

מצב Sandbox

נקודות קצה sandbox הן חינמיות ולא צורכות מכסה. השתמש בהן ל:

  • פיתוח - בנה ובדוק את האינטגרציה שלך
  • בדיקות - אמת טיפול בבקשות/תגובות
  • הדגמות - הצג יכולות API ללא עלות
נקודות קצה Sandbox

החלף /analyze ב-/sandbox בכל נקודת קצה ייצור:

  • /api/v11/01-06-2025/sandbox
  • /api/v11/health-score/sandbox
  • /api/v1/nutrition/sandbox
  • /api/v1/bloodtest/comparison/sandbox

בדיקת מכסה

השתמש בנקודת הקצה quota כדי לעקוב אחר הקרדיטים הנותרים שלך:

curl -X POST "https://app.aibloodtestinterpret.com/api/quota/check" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "YOUR_USERNAME",
    "password": "YOUR_PASSWORD"
  }'

תגובה

{
  "status": "success",
  "data": {
    "username": "your_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"
  }
}
מה לעשות כאשר המכסה תמה
  1. רכוש קרדיטים נוספים ב-kantesti.net
  2. השתמש בנקודות קצה sandbox לבדיקות בינתיים
  3. צור קשר עם התמיכה לתוכניות ארגוניות עם מגבלות גבוהות יותר

שיטות עבודה מומלצות

אופטימיזציה של שימוש במכסה

  • השתמש ב-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();
}

תוכניות ארגוניות

לשימוש בנפח גבוה, צור איתנו קשר לתוכניות ארגוניות עם:

  • מגבלות מכסה גבוהות יותר
  • הנחות נפח
  • תמיכה עדיפה
  • SLAs מותאמים אישית
  • תשתית ייעודית

יצירת קשר: [email protected]