Authentification

Découvrez comment authentifier vos requêtes API et gérer votre quota.

Aperçu

L'API Kantesti utilise une authentification basée sur les identifiants. Chaque requête API doit inclure votre nom d'utilisateur et votre mot de passe dans le corps de la requête.

Méthode d'Authentification

Les identifiants sont envoyés sous forme de form-data ou de corps JSON avec chaque requête. Aucune clé API ou token requis.

Identifiants API

Vos identifiants API se composent de :

ChampTypeDescription
username string Votre nom d'utilisateur API unique
password string Votre mot de passe API sécurisé

Format de la Requête

Incluez vos identifiants dans chaque requête API. Vous pouvez utiliser le format form-data ou JSON :

Form Data (Multipart)

curl -X POST "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze" \
  -F "username=VOTRE_NOM_UTILISATEUR" \
  -F "password=VOTRE_MOT_DE_PASSE" \
  -F "language=fr" \
  -F "file=@test_sanguin.pdf"

Corps JSON (pour certains points de terminaison)

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"
  }'

Bonnes Pratiques de Sécurité

Directives de Sécurité
  • Ne jamais exposer les identifiants dans le code côté client (JavaScript exécuté dans les navigateurs)
  • Utiliser les variables d'environnement pour stocker les identifiants dans votre backend
  • Toujours utiliser HTTPS - toutes les requêtes API sont chiffrées
  • Changer les mots de passe périodiquement pour une sécurité renforcée
  • Utiliser un proxy backend lors de la création d'applications web

Gestion des Quotas

Chaque compte dispose d'un quota API (crédits). Chaque requête de production réussie consomme 1 crédit. Les requêtes sandbox ne consomment pas de quota.

Vérifier Votre Quota

Utilisez le point de terminaison quota pour vérifier vos crédits restants :

POST /api/quota/check

Requête :

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"
  }
}

Erreurs d'Authentification

Code d'ErreurMessageSolution
AUTH_1001 Identifiants d'authentification manquants Inclure le nom d'utilisateur et le mot de passe
AUTH_1002 Nom d'utilisateur ou mot de passe invalide Vérifier que vos identifiants sont corrects
AUTH_1003 Compte temporairement verrouillé Attendre et réessayer, ou contacter le support

Prochaines Étapes