Uwierzytelnianie

Dowiedz się, jak uwierzytelniać żądania API i zarządzać limitem.

Przegląd

API Kantesti używa uwierzytelniania opartego na danych logowania. Każde żądanie API musi zawierać nazwę użytkownika i hasło w treści żądania.

Metoda Uwierzytelniania

Dane logowania są wysyłane jako form-data lub treść JSON z każdym żądaniem. Nie jest wymagany klucz API ani token.

Dane Uwierzytelniające API

Twoje dane uwierzytelniające API składają się z:

PoleTypOpis
username string Twoja unikalna nazwa użytkownika API
password string Twoje bezpieczne hasło API

Format Żądania

Dołącz dane uwierzytelniające w każdym żądaniu API. Możesz użyć formatu form-data lub JSON:

Form Data (Multipart)

curl -X POST "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze" \
  -F "username=TWOJA_NAZWA_UZYTKOWNIKA" \
  -F "password=TWOJE_HASLO" \
  -F "language=pl" \
  -F "file=@badanie_krwi.pdf"

Treść JSON (dla niektórych punktów końcowych)

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

Najlepsze Praktyki Bezpieczeństwa

Wytyczne Bezpieczeństwa
  • Nigdy nie ujawniaj danych uwierzytelniających w kodzie po stronie klienta (JavaScript w przeglądarkach)
  • Używaj zmiennych środowiskowych do przechowywania danych uwierzytelniających w backendzie
  • Zawsze używaj HTTPS - wszystkie żądania API są szyfrowane
  • Okresowo zmieniaj hasła dla zwiększonego bezpieczeństwa
  • Używaj proxy backendowego przy tworzeniu aplikacji webowych

Zarządzanie Limitem

Każde konto ma limit API (kredyty). Każde udane żądanie produkcyjne zużywa 1 kredyt. Żądania sandbox nie zużywają limitu.

Sprawdzanie Limitu

Użyj punktu końcowego quota, aby sprawdzić pozostałe kredyty:

POST /api/quota/check

Żądanie:

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

Odpowiedź:

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

Błędy Uwierzytelniania

Kod BłęduWiadomośćRozwiązanie
AUTH_1001 Brakujące dane uwierzytelniające Dołącz nazwę użytkownika i hasło
AUTH_1002 Nieprawidłowa nazwa użytkownika lub hasło Sprawdź, czy dane uwierzytelniające są poprawne
AUTH_1003 Konto tymczasowo zablokowane Poczekaj i spróbuj ponownie lub skontaktuj się z pomocą

Następne Kroki