المصادقة
اكتشف كيفية مصادقة طلبات 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 |
الحساب مقفل مؤقتًا | انتظر وأعد المحاولة، أو اتصل بالدعم |
الخطوات التالية
- نقاط نهاية API - استكشف جميع نقاط النهاية المتاحة
- حدود الاستخدام - فهم إدارة الحصص
- رموز الأخطاء - مرجع كامل للأخطاء