API korlátok

Az API használati korlátai és a kvótakezelés megértése.

Áttekintés

A Kantesti API kredit alapú kvótarendszert használ. Minden sikeres production kérés 1 kreditet fogyaszt a fiókja kvótájából.

Sandbox mód

A sandbox végpontok ingyenesek, és nem fogyasztanak kvótát. Használja őket:

• Fejlesztés — Az integráció elkészítése és tesztelése
• Tesztelés — A kérés/válasz kezelés ellenőrzése
• Demók — Az API képességeinek bemutatása költség nélkül

Kvóta ellenőrzése

Használja a kvóta-ellenőrzési végpontot a megmaradt kreditek monitorozásához:

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

Válasz

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

Kvóta túllépése esetén

Ha kimerül a kvótája, az API QUOTA_1101 hibát ad vissza:

{
  "status": "error",
  "error": {
    "code": "QUOTA_1101",
    "message": "Elégtelen API kvóta",
    "details": "Aktuális kvóta: 0. Látogasson el weboldalunkra további kreditek vásárlásához.",
    "timestamp": "2025-12-22T10:30:00Z"
  }
}

Bevált gyakorlatok

A kvótahasználat optimalizálása

• Használjon sandboxot fejlesztéshez — Csak akkor váltson production környezetre, amikor készen áll
• Kötegelje a tesztfeltöltéseket — Egyesítsen több oldalt egyetlen PDF-be
• Cache-elje az eredményeket — Tárolja az elemzési eredményeket az újrafeldolgozás elkerülése érdekében
• Figyelje a használatot — Rendszeresen ellenőrizze a megmaradt kvótát

Kvótahibák kezelése

async function analyzeWithQuotaCheck(file) {
  // Kvóta ellenőrzése a kérés elküldése előtt
  const quotaResponse = await checkQuota();

  if (quotaResponse.data.remaining_quota < 1) {
    throw new Error('Nincs több kvóta. Kérjük, vásároljon további krediteket.');
  }

  // Elemzés folytatása
  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 előfizetések

Nagy volumenű használathoz forduljon hozzánk enterprise előfizetésekért, amelyek tartalmazzák:

• Magasabb kvótakorlátok
• Mennyiségi kedvezmények
• Elsőbbségi támogatás
• Egyedi SLA-k
• Dedikált infrastruktúra

Kapcsolat: [email protected]