Limiti di Utilizzo

Comprendere i limiti di utilizzo dell'API e la gestione delle quote.

Panoramica

L'API Kantesti utilizza un sistema di quote basato su crediti. Ogni richiesta di produzione riuscita consuma 1 credito dalla quota del tuo account.

Modalità Sandbox

Gli endpoint sandbox sono gratuiti e non consumano quota. Usali per:

• Sviluppo - Costruisci e testa la tua integrazione
• Testing - Valida la gestione di richieste/risposte
• Demo - Mostra le capacità dell'API senza costi

Controllo della Quota

Usa l'endpoint di controllo quota per monitorare i crediti rimanenti:

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

Risposta

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

Quando la Quota è Esaurita

Quando la quota è esaurita, l'API restituisce un errore QUOTA_1101:

{
  "status": "error",
  "error": {
    "code": "QUOTA_1101",
    "message": "Quota API insufficiente",
    "details": "Quota attuale: 0. Visita il nostro sito per acquistare più crediti.",
    "timestamp": "2025-12-22T10:30:00Z"
  }
}

Best Practice

Ottimizza l'Utilizzo della Quota

• Usa sandbox per lo sviluppo - Passa alla produzione solo quando sei pronto
• Raggruppa gli upload dei test - Combina più pagine in un singolo PDF
• Memorizza i risultati nella cache - Salva i risultati delle analisi per evitare rielaborazioni
• Monitora l'utilizzo - Controlla regolarmente la quota rimanente

Gestione degli Errori di Quota

async function analyzeWithQuotaCheck(file) {
  // Controlla la quota prima di fare la richiesta
  const quotaResponse = await checkQuota();

  if (quotaResponse.data.remaining_quota < 1) {
    throw new Error('Nessuna quota rimanente. Acquista più crediti.');
  }

  // Procedi con l'analisi
  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();
}

Piani Enterprise

Per utilizzi ad alto volume, contattaci per piani enterprise con:

• Limiti di quota più alti
• Sconti per volumi
• Supporto prioritario
• SLA personalizzati
• Infrastruttura dedicata

Contatto: [email protected]