Autenticazione

Scopri come autenticare le tue richieste API e gestire la tua quota.

Panoramica

L'API Kantesti utilizza l'autenticazione basata su credenziali. Ogni richiesta API deve includere il tuo username e la tua password nel corpo della richiesta.

Metodo di Autenticazione

Le credenziali vengono inviate come form-data o corpo JSON con ogni richiesta. Non sono richieste chiavi API o token.

Credenziali API

Le tue credenziali API sono composte da:

CampoTipoDescrizione
username string Il tuo username API univoco
password string La tua password API sicura

Formato della Richiesta

Includi le tue credenziali in ogni richiesta API. Puoi utilizzare il formato form-data o JSON:

Form Data (Multipart)

curl -X POST "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze" \
  -F "username=TUO_USERNAME" \
  -F "password=TUA_PASSWORD" \
  -F "language=it" \
  -F "file=@test_sangue.pdf"

Corpo JSON (per alcuni endpoint)

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

Best Practice di Sicurezza

Linee Guida di Sicurezza
  • Non esporre mai le credenziali nel codice client-side (JavaScript in esecuzione nei browser)
  • Utilizza variabili d'ambiente per memorizzare le credenziali nel tuo backend
  • Usa sempre HTTPS - tutte le richieste API sono crittografate
  • Ruota le password periodicamente per una maggiore sicurezza
  • Usa un proxy backend se stai sviluppando applicazioni web

Gestione della Quota

Ogni account ha una quota API (crediti). Ogni richiesta di produzione riuscita consuma 1 credito. Le richieste sandbox non consumano quota.

Controlla la Tua Quota

Utilizza l'endpoint quota per controllare i tuoi crediti rimanenti:

POST /api/quota/check

Richiesta:

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

Risposta:

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

Errori di Autenticazione

Codice ErroreMessaggioSoluzione
AUTH_1001 Credenziali di autenticazione mancanti Includi sia username che password
AUTH_1002 Username o password non validi Verifica che le tue credenziali siano corrette
AUTH_1003 Account temporaneamente bloccato Attendi e riprova, o contatta il supporto

Prossimi Passi