REST بصيغة JSON، المسار: /api/v1/...، التوثيق عبر OpenAPI (Swagger/Scribe).
| المجموعة | أمثلة |
|---|---|
| المصادقة | POST /auth/register · /auth/login · /auth/otp · /auth/refresh · /auth/logout |
| الاستبيان | GET /questionnaire · POST /questionnaire/answers |
| الاشتراك | GET /plans · POST /subscriptions · GET /subscriptions/current |
| الدفع | POST /payments · POST /webhooks/payment |
| البرنامج | GET /me/program · POST /workouts/sessions · POST /workouts/sessions/{id}/sets |
| التغذية | GET /me/meal-plan · POST /food-logs · GET /foods?q= |
| التقدّم | POST /measurements · POST /photos · GET /me/progress · GET /me/reports |
| العادات | POST /habits/logs · POST /water |
| الدردشة | GET /conversations · POST /messages + قناة WebSocket |
| الاجتماعات | GET /meetings · POST /meetings |
| الإشعارات | GET /notifications · POST /devices (تسجيل FCM) |
| التتبع | POST /track/events · POST /track/video |
| المساعد | POST /assistant/messages |
اتفاقيات: ترقيم صفحات موحّد، أخطاء بصيغة موحّدة، Accept-Language لتحديد اللغة، إصدار التطبيق في الترويسة لدعم التحديث الإجباري.