مستندات API

۳۴ مسیر API عمومی و احراز هویت‌شده با توضیحات کامل.

GET/api/foodsدریافت دیتابیس غذاها با فیلتر و جستجو

GET/api/recipesلیست دستور پخت‌ها با فیلتر تگ و جستجو

GET/api/articlesلیست مقالات یا یک مقاله با slug

POST/api/planمحاسبه BMR/TDEE و درشت‌مغذی‌ها

POST/api/meal-planتولید برنامه غذایی روزانه با AI

POST/api/weekly-planتولید برنامه هفتگی با AI + لیست خرید

POST/api/recipe-generatorتولید دستور پخت از مواد اولیه با AI

POST/api/food-recognizeتشخیص غذا از عکس با VLM

POST/api/analyze-mealتحلیل وعده با توصیف متنی (AI)

POST/api/suggest-mealپیشنهاد وعده بر اساس کالری باقیمانده

POST/api/macro-splitمحاسبه توزیع درشت‌مغذی با ۴ گزینه

GET/POST/DELETE/api/trackingردیابی وعده‌های غذایی

GET/api/progressآمار پیشرفت هفتگی

GET/POST/DELETE/api/workoutsردیابی تمرین‌ها و کالری سوزانده

GET/POST/DELETE/api/weightردیابی وزن و BMI

GET/POST/DELETE/api/waterردیابی مصرف آب روزانه

GET/POST/DELETE/api/custom-foodsمدیریت غذاهای سفارشی کاربر

POST/api/shopping-listتولید لیست خرید از دستور پخت‌ها

GET/POST/api/favoritesمدیریت علاقه‌مندی‌هانیاز به ورود

GET/POST/api/ratingsامتیازدهی به دستور پختنیاز به ورود

GET/POST/DELETE/api/commentsنظرات دستور پختنیاز به ورود

GET/POST/api/votesرای مفید بودن مقاله

GET/POST/api/preferencesترجیحات سلامتی و رژیم

GET/api/insightsتحلیل هوش مصنوعی هفتگی

GET/api/badgesنشان‌های دستاورد کاربر

GET/api/food-scoreامتیاز تغذیه‌ای ۰-۱۰۰ غذا

GET/api/seasonalغذاهای فصلی ماه جاری

GET/api/daily-tipنکته سلامتی روز

GET/api/exportصادرات داده به CSV/JSON

GET/api/healthبررسی سلامت سرور

GET/api/versionنسخه اپلیکیشن

POST/api/chatدستیار هوش مصنوعی چت

POST/api/analyticsثبت بازدید صفحه

POST/api/vitalsثبت Core Web Vitals

نکات استفاده

• تمام پاسخ‌ها در قالب JSON هستند.

• مسیرهای با علامت 🔒 نیاز به ورود دارند (NextAuth session).

• مسیرهای AI ممکن است تا ۴۰ ثانیه طول بکشند.

• نرخ درخواست: حداکثر ۶۰ درخواست در دقیقه برای هر IP.

• برای مثال‌ها به آمار پلتفرم مراجعه کنید.