Limites d'Utilisation

Comprendre les limites d'utilisation de l'API et la gestion des quotas.

Aperçu

L'API Kantesti utilise un système de quotas basé sur les crédits. Chaque requête de production réussie consomme 1 crédit de votre quota de compte.

Système de Quotas
Requêtes de production1 crédit par requête réussie
Requêtes sandboxGratuites (aucun quota consommé)
Requêtes échouéesAucun quota consommé

Mode Sandbox

Les points d'accès sandbox sont gratuits et ne consomment pas de quota. Utilisez-les pour :

  • Développement - Construisez et testez votre intégration
  • Tests - Validez la gestion des requêtes/réponses
  • Démos - Montrez les capacités de l'API sans coût
Points d'Accès Sandbox

Remplacez /analyze par /sandbox dans n'importe quel point d'accès de production :

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

Vérification du Quota

Utilisez le point d'accès de vérification de quota pour surveiller vos crédits restants :

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

Réponse

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

Quand le Quota est Épuisé

Lorsque votre quota est épuisé, l'API renvoie une erreur QUOTA_1101 :

{
  "status": "error",
  "error": {
    "code": "QUOTA_1101",
    "message": "Quota API insuffisant",
    "details": "Quota actuel : 0. Visitez notre site pour acheter plus de crédits.",
    "timestamp": "2025-12-22T10:30:00Z"
  }
}
Que faire quand le quota est épuisé
  1. Achetez des crédits supplémentaires sur kantesti.net
  2. Utilisez les points d'accès sandbox pour les tests en attendant
  3. Contactez le support pour des plans entreprise avec des limites plus élevées

Bonnes Pratiques

Optimiser l'Utilisation du Quota

  • Utilisez sandbox pour le développement - Passez en production uniquement quand vous êtes prêt
  • Regroupez les téléchargements de tests - Combinez plusieurs pages dans un seul PDF
  • Mettez en cache les résultats - Stockez les résultats d'analyse pour éviter le retraitement
  • Surveillez l'utilisation - Vérifiez régulièrement le quota restant

Gérer les Erreurs de Quota

async function analyzeWithQuotaCheck(file) {
  // Vérifier le quota avant de faire la requête
  const quotaResponse = await checkQuota();

  if (quotaResponse.data.remaining_quota < 1) {
    throw new Error('Plus de quota restant. Veuillez acheter plus de crédits.');
  }

  // Procéder à l'analyse
  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();
}

Plans Entreprise

Pour une utilisation à fort volume, contactez-nous pour des plans entreprise avec :

  • Des limites de quota plus élevées
  • Des réductions sur le volume
  • Un support prioritaire
  • Des SLA personnalisés
  • Une infrastructure dédiée

Contact : [email protected]