Удостоверяване

Научете как да удостоверявате API заявките си и да управлявате квотата си.

Преглед

Kantesti API използва удостоверяване, базирано на удостоверителни данни. Всяка API заявка трябва да включва вашето потребителско име и парола в тялото на заявката.

Метод за удостоверяване

Удостоверителните данни се изпращат като form-data или JSON тяло с всяка заявка. Не се изискват API ключове или токени.

API удостоверителни данни

Вашите API удостоверителни данни се състоят от:

Поле	Тип	Описание
`username`	string	Вашето уникално API потребителско име
`password`	string	Вашата защитена API парола

Формат на заявката

Включвайте вашите удостоверителни данни във всяка API заявка. Можете да използвате формат form-data или JSON:

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 тяло (за някои крайни точки)

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

Най-добри практики за сигурност

Указания за сигурност

Никога не излагайте удостоверителните данни в клиентски код (JavaScript в браузъри)
Използвайте променливи на средата, за да съхранявате удостоверителните данни в бекенда си
Винаги използвайте HTTPS — всички API заявки са криптирани
Завъртайте паролите периодично за повишена сигурност
Използвайте backend прокси, ако изграждате уеб приложения

Управление на квотата

Всеки акаунт има API квота (кредити). Всяка успешна production заявка консумира 1 кредит. Sandbox заявките не консумират квота.

Проверете вашата квота

Използвайте квотната крайна точка, за да проверите оставащите си кредити:

Заявка:

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

Отговор:

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

Грешки при удостоверяване

Код на грешка	Съобщение	Решение
`AUTH_1001`	Липсващи удостоверителни данни	Включете както потребителско име, така и парола
`AUTH_1002`	Невалидно потребителско име или парола	Проверете дали удостоверителните данни са правилни
`AUTH_1003`	Акаунтът е временно заключен	Изчакайте и опитайте отново или се свържете с поддръжката

Следващи стъпки

API крайни точки — Разгледайте всички налични крайни точки
Лимити — Разберете управлението на квотата
Кодове за грешки — Пълна справка за грешките