وثائق واجهة البرمجة

ابنِ تطبيقات صحية على واجهة برمجة ClapDiet — واجهة REST لتحليل التحاليل وبيانات الأطعمة والتوصيات الغذائية المخصصة.

البدء السريع

واجهة برمجة ClapDiet في وصول محدود وليست ذاتية الخدمة بعد: لا يوجد مفتاح تنشئه من إعدادات حسابك. راسلنا وسنجهّز بيانات اعتمادك.

أرسل رمزك في ترويسة Authorization مع كل طلب. على سبيل المثال:

curl -X GET https://api.clapdiet.com/api/v1/foods \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

كل استجابة بصيغة JSON. تحقق من رمز الحالة: 200 يعني النجاح، بينما ترمز 400 و500 إلى وجود خطأ.

تستخدم واجهة برمجة ClapDiet رموز Bearer. ضع رمزك في ترويسة Authorization مع كل طلب.

مهم: لا تشارك رمزك أبدًا ولا تضعه في شيفرة تعمل لدى العميل حيث يمكن للآخرين قراءته. احتفظ به على خادمك.

POST/api/v1/auth/registerإنشاء حساب مستخدم جديد

POST/api/v1/auth/loginتسجيل الدخول والحصول على رموز الوصول

GET/api/v1/labsعرض نتائج تحاليل المستخدم

POST/api/v1/labs/uploadرفع نتائج تحاليل جديدة (PDF أو صورة)

GET/api/v1/foodsالبحث في قاعدة بيانات الأطعمة

GET/api/v1/recommendationsالحصول على توصيات غذائية مخصصة

لإبقاء الواجهة سريعة وعادلة للجميع، تُحدّد الطلبات ضمن ثلاث نوافذ متداخلة. وتُطبَّق الثلاث في آنٍ واحد.

في الثانية

كل 10 ثوانٍ

100

في الدقيقة

هذه هي القيم الافتراضية التي تُشحن مع الخدمة؛ ويمكن للمشغّل تشديدها.

فريقنا هنا لمساعدتك على البناء باستخدام الواجهة.