Лимити

Разбиране на лимитите за използване на API и управлението на квотата.

Преглед

Kantesti API използва квотна система, базирана на кредити. Всяка успешна production заявка консумира 1 кредит от квотата на вашия акаунт.

Sandbox режим

Sandbox крайните точки са безплатни и не консумират квота. Използвайте ги за:

• Разработка — Изградете и тествайте интеграцията си
• Тестване — Валидирайте обработката на заявки/отговори
• Демонстрации — Покажете възможностите на API без разходи

Проверка на вашата квота

Използвайте крайната точка за проверка на квотата, за да наблюдавате оставащите си кредити:

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": "Insufficient API quota",
    "details": "Current quota: 0. Visit our website to purchase more credits.",
    "timestamp": "2025-12-22T10:30:00Z"
  }
}

Най-добри практики

Оптимизирайте използването на квотата

• Използвайте sandbox за разработка — Преминете към production само когато сте готови
• Групирайте тестовите качвания — Комбинирайте множество страници в един 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();
}

Корпоративни планове

За използване с голям обем, свържете се с нас за корпоративни планове с:

• По-високи лимити на квотата
• Отстъпки за обем
• Приоритетна поддръжка
• Персонализирани SLA-та
• Специализирана инфраструктура

Контакт: [email protected]