Nutzungslimits

Verstehen Sie API-Nutzungslimits und Kontingentverwaltung.

Übersicht

Die Kantesti API verwendet ein kreditbasiertes Kontingenzsystem. Jede erfolgreiche Produktionsanfrage verbraucht 1 Credit aus Ihrem Kontokontingent.

Sandbox-Modus

Sandbox-Endpunkte sind kostenlos und verbrauchen kein Kontingent. Verwenden Sie sie für:

• Entwicklung - Erstellen und testen Sie Ihre Integration
• Testing - Validieren Sie die Anfrage-/Antwortverarbeitung
• Demos - Zeigen Sie API-Fähigkeiten ohne Kosten

Kontingent überprüfen

Verwenden Sie den Kontingentprüfungs-Endpunkt, um Ihre verbleibenden Credits zu überwachen:

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

Antwort

{
  "status": "success",
  "data": {
    "username": "ihr_benutzername",
    "remaining_quota": 150,
    "timestamp": "2025-12-22T10:30:00Z"
  }
}

Wenn das Kontingent erschöpft ist

Wenn Ihr Kontingent erschöpft ist, gibt die API einen QUOTA_1101-Fehler zurück:

{
  "status": "error",
  "error": {
    "code": "QUOTA_1101",
    "message": "Unzureichendes API-Kontingent",
    "details": "Aktuelles Kontingent: 0. Besuchen Sie unsere Website, um mehr Credits zu kaufen.",
    "timestamp": "2025-12-22T10:30:00Z"
  }
}

Best Practices

Kontingentnutzung optimieren

• Verwenden Sie Sandbox für die Entwicklung - Wechseln Sie erst zur Produktion, wenn Sie bereit sind
• Bündeln Sie Test-Uploads - Kombinieren Sie mehrere Seiten in einer einzelnen PDF
• Ergebnisse zwischenspeichern - Speichern Sie Analyseergebnisse, um Neuverarbeitung zu vermeiden
• Nutzung überwachen - Überprüfen Sie regelmäßig das verbleibende Kontingent

Kontingentfehler behandeln

async function analyzeWithQuotaCheck(file) {
  // Kontingent vor der Anfrage prüfen
  const quotaResponse = await checkQuota();

  if (quotaResponse.data.remaining_quota < 1) {
    throw new Error('Kein Kontingent übrig. Bitte kaufen Sie mehr Credits.');
  }

  // Mit der Analyse fortfahren
  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();
}

Enterprise-Pläne

Für hohe Nutzungsvolumen kontaktieren Sie uns für Enterprise-Pläne mit:

• Höhere Kontingentlimits
• Mengenrabatte
• Prioritäts-Support
• Individuelle SLAs
• Dedizierte Infrastruktur

Kontakt: [email protected]