Authentifizierung

Erfahren Sie, wie Sie Ihre API-Anfragen authentifizieren und Ihr Kontingent verwalten.

Übersicht

Die Kantesti API verwendet anmeldedatenbasierte Authentifizierung. Jede API-Anfrage muss Ihren Benutzernamen und Ihr Passwort im Anfragekörper enthalten.

Authentifizierungsmethode

Anmeldedaten werden als form-data oder JSON-Body mit jeder Anfrage gesendet. Keine API-Schlüssel oder Tokens erforderlich.

API-Anmeldedaten

Ihre API-Anmeldedaten bestehen aus:

FeldTypBeschreibung
username string Ihr eindeutiger API-Benutzername
password string Ihr sicheres API-Passwort

Anfrageformat

Fügen Sie Ihre Anmeldedaten in jede API-Anfrage ein. Sie können entweder form-data oder JSON-Format verwenden:

Form Data (Multipart)

curl -X POST "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze" \
  -F "username=IHR_BENUTZERNAME" \
  -F "password=IHR_PASSWORT" \
  -F "language=de" \
  -F "[email protected]"

JSON Body (für einige Endpunkte)

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

Sicherheits-Best-Practices

Sicherheitsrichtlinien
  • Niemals Anmeldedaten offenlegen in clientseitigem Code (JavaScript im Browser)
  • Umgebungsvariablen verwenden um Anmeldedaten in Ihrem Backend zu speichern
  • Immer HTTPS verwenden - alle API-Anfragen sind verschlüsselt
  • Passwörter regelmäßig wechseln für erhöhte Sicherheit
  • Backend-Proxy verwenden beim Erstellen von Webanwendungen

Kontingentverwaltung

Jedes Konto hat ein API-Kontingent (Credits). Jede erfolgreiche Produktionsanfrage verbraucht 1 Credit. Sandbox-Anfragen verbrauchen kein Kontingent.

Kontingent prüfen

Verwenden Sie den Kontingent-Endpunkt, um Ihre verbleibenden Credits zu überprüfen:

POST /api/quota/check

Anfrage:

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

Antwort:

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

Authentifizierungsfehler

FehlercodeNachrichtLösung
AUTH_1001 Authentifizierungsdaten fehlen Benutzername und Passwort angeben
AUTH_1002 Ungültiger Benutzername oder Passwort Überprüfen Sie Ihre Anmeldedaten
AUTH_1003 Konto vorübergehend gesperrt Warten und erneut versuchen, oder Support kontaktieren

Nächste Schritte