المصادقة

اكتشف كيفية مصادقة طلبات API وإدارة حصتك.

نظرة عامة

يستخدم API Kantesti مصادقة قائمة على بيانات الاعتماد. يجب أن يتضمن كل طلب 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=اسم_المستخدم" \
  -F "password=كلمة_المرور" \
  -F "language=ar" \
  -F "file=@فحص_الدم.pdf"

نص JSON (لنقاط نهاية معينة)

curl -X POST "https://app.aibloodtestinterpret.com/api/quota/check" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "اسم_المستخدم",
    "password": "كلمة_المرور"
  }'

أفضل ممارسات الأمان

إرشادات الأمان
  • لا تكشف بيانات الاعتماد أبدًا في التعليمات البرمجية من جانب العميل (JavaScript يعمل في المتصفحات)
  • استخدم متغيرات البيئة لتخزين بيانات الاعتماد في الخادم الخلفي
  • استخدم دائمًا HTTPS - جميع طلبات API مشفرة
  • قم بتغيير كلمات المرور بشكل دوري لمزيد من الأمان
  • استخدم وكيل خادم خلفي عند إنشاء تطبيقات ويب

إدارة الحصص

لكل حساب حصة API (رصيد). كل طلب إنتاج ناجح يستهلك رصيدًا واحدًا. طلبات sandbox لا تستهلك حصة.

تحقق من حصتك

استخدم نقطة نهاية الحصة للتحقق من الرصيد المتبقي:

POST /api/quota/check

الطلب:

curl -X POST "https://app.aibloodtestinterpret.com/api/quota/check" \
  -H "Content-Type: application/json" \
  -d '{"username": "اسم_المستخدم", "password": "كلمة_المرور"}'

الاستجابة:

{
  "status": "success",
  "data": {
    "username": "اسم_المستخدم",
    "remaining_quota": 150,
    "timestamp": "2025-12-22T10:30:00Z"
  }
}

أخطاء المصادقة

رمز الخطأالرسالةالحل
AUTH_1001 بيانات اعتماد المصادقة مفقودة قم بتضمين اسم المستخدم وكلمة المرور
AUTH_1002 اسم المستخدم أو كلمة المرور غير صالحة تحقق من صحة بيانات الاعتماد
AUTH_1003 الحساب مقفل مؤقتًا انتظر وأعد المحاولة، أو اتصل بالدعم

الخطوات التالية