Hitelesítés

Ismerje meg, hogyan hitelesítse API-kéréseit és hogyan kezelje kvótáját.

Áttekintés

A Kantesti API hitelesítő adatokon alapuló hitelesítést használ. Minden API kérésnek tartalmaznia kell a felhasználónevet és jelszót a kérés törzsében.

Hitelesítési módszer

A hitelesítő adatokat form-data vagy JSON törzs formájában küldjük minden kéréssel. Nincs szükség API kulcsokra vagy tokenekre.

API hitelesítő adatok

Az API hitelesítő adatai a következőkből állnak:

Mező	Típus	Leírás
`username`	string	Az Ön egyedi API felhasználóneve
`password`	string	Az Ön biztonságos API jelszava

Kérés formátuma

Minden API kérésbe foglalja bele a hitelesítő adatait. Használhat form-data vagy JSON formátumot:

Form Data (Multipart)

curl -X POST "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze" \
  -F "username=YOUR_USERNAME" \
  -F "password=YOUR_PASSWORD" \
  -F "language=en" \
  -F "file=@blood_test.pdf"

JSON törzs (egyes végpontokhoz)

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

Biztonsági bevált gyakorlatok

Biztonsági irányelvek

Soha ne tegye közzé a hitelesítő adatokat kliensoldali kódban (böngészőben futó JavaScript)
Használjon környezeti változókat a hitelesítő adatok backendben való tárolásához
Mindig használjon HTTPS-t — minden API kérés titkosított
Időszakosan cserélje a jelszavakat a fokozott biztonságért
Használjon backend proxyt, ha webalkalmazásokat épít

Kvótakezelés

Minden fiók rendelkezik egy API kvótával (kreditek). Minden sikeres production kérés 1 kreditet fogyaszt. A sandbox kérések nem fogyasztanak kvótát.

Kvóta ellenőrzése

Használja a kvóta végpontot a megmaradt kreditek ellenőrzéséhez:

Kérés:

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

Válasz:

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

Hitelesítési hibák

Hibakód	Üzenet	Megoldás
`AUTH_1001`	Hiányzó hitelesítő adatok	Adja meg mind a felhasználónevet, mind a jelszót
`AUTH_1002`	Érvénytelen felhasználónév vagy jelszó	Ellenőrizze a hitelesítő adatok helyességét
`AUTH_1003`	A fiók ideiglenesen zárolva	Várjon, és próbálja újra, vagy forduljon az ügyfélszolgálathoz

Következő lépések

API végpontok — Fedezze fel az összes elérhető végpontot
API korlátok — Ismerje meg a kvótakezelést
Hibakódok — Teljes hibareferencia