مرجع الأخطاء

دليل شامل لكل خطأ قد يظهر في تطبيق مرا — ما يعنيه وكيفية حلّه.

67 خطأ في 15 قسم67 errors across 15 categories
أخطاء المصادقة(5)
رمز غير صالح أو منتهي الصلاحية
HTTP 401
متى يظهر
انتهت جلسة تسجيل الدخول أو أن الرمز غير صالح.
ماذا تفعل
أغلق التطبيق وسجّل دخولك مجدداً. إذا استمرت المشكلة، سجّل خروج كاملاً ثم أعد تسجيل الدخول.
البريد الإلكتروني غير مُحقّق
HTTP 401
الرسالة
Email not verified. Please verify your email address.
متى يظهر
سجّلت حساباً لكن لم تُحقّق بريدك الإلكتروني.
ماذا تفعل
تحقق من بريدك الوارد (ومجلد الرسائل غير المرغوبة) بحثاً عن رسالة التحقق. اضغط الرابط، ثم حاول تسجيل الدخول مجدداً. يمكنك طلب رسالة تحقق جديدة من شاشة الدخول.
الحساب معطّل
HTTP 401
الرسالة
Account is deactivated. Please contact support.
متى يظهر
تم تعطيل حسابك من قبل المسؤول.
ماذا تفعل
تواصل مع دعم مرا على support@mara.health لإعادة تفعيل حسابك.
المستخدم غير موجود
HTTP 401
الرسالة
User not found. Please register first.
متى يظهر
تحاول تسجيل الدخول بحساب غير مسجّل.
ماذا تفعل
أنشئ حساباً جديداً. إذا كنت تعتقد أن لديك حساباً بالفعل، تأكد من استخدام البريد الإلكتروني الصحيح.
تفويض مفقود
HTTP 401
متى يظهر
فشل التطبيق في إرسال رمز المصادقة.
ماذا تفعل
سجّل خروج ثم أعد تسجيل الدخول. إذا استمرت المشكلة، امسح بيانات التطبيق وأعد تثبيته.
أخطاء الصلاحيات(5)
تجاوز حد الأجهزة
HTTP 403DEVICE_LIMIT_EXCEEDED
متى يظهر
وصلت الحد الأقصى لعدد الأجهزة في خطتك.
ماذا تفعل
الخطة المجانية: جهاز واحد. بريميوم: 3 أجهزة. اذهب إلى الإعدادات > الأجهزة واحذف جهازاً قديماً، أو قم بالترقية إلى بريميوم.
يتطلب اشتراك بريميوم
HTTP 403
الرسالة
This feature requires a premium subscription
متى يظهر
حاولت استخدام ميزة متاحة فقط لمشتركي بريميوم.
ماذا تفعل
قم بالترقية إلى مرا بريميوم من الإعدادات > الاشتراك.
الوصول مرفوض
HTTP 403
الرسالة
Access denied
متى يظهر
ليس لديك صلاحية لهذا الإجراء.
ماذا تفعل
تأكد من تسجيل دخولك بالحساب الصحيح. بعض الميزات تتطلب أدواراً أو موافقات محددة.
الموافقة مطلوبة
HTTP 403
متى يظهر
تحتاج لمنح الموافقة قبل الوصول للميزات الصحية.
ماذا تفعل
اذهب إلى الإعدادات > الخصوصية والموافقات واقبل الموافقة المطلوبة.
غير مصرّح بهذا الإجراء
HTTP 403
الرسالة
You are not authorized to confirm this action.
متى يظهر
تحاول تأكيد إجراء صحي يخص مستخدماً آخر.
ماذا تفعل
تأكد من تسجيل دخولك بالحساب الصحيح.
تعارضات الحساب(2)
تعارض البريد/المعرّف
HTTP 409EMAIL_UID_CONFLICT
متى يظهر
تم إعادة إنشاء حسابك في Firebase لكن قاعدة البيانات لا تزال مرتبطة بالحساب القديم.
ماذا تفعل
في معظم الحالات، يُحل تلقائياً عند محاولة الدخول التالية. إذا استمر الخطأ، تواصل مع الدعم مع بريدك الإلكتروني.
المستخدم موجود بالفعل
HTTP 409
الرسالة
User already exists.
متى يظهر
تحاول التسجيل ببريد إلكتروني لديه حساب بالفعل.
ماذا تفعل
استخدم شاشة تسجيل الدخول. إذا نسيت كلمة المرور، استخدم "نسيت كلمة المرور" لإعادة تعيينها.
تحديد المعدل(4)
طلبات كثيرة جداً
HTTP 429
الرسالة
Rate limit exceeded. Please try again later.
متى يظهر
أرسلت طلبات كثيرة في وقت قصير.
ماذا تفعل
انتظر قليلاً وحاول مجدداً. ترويسة Retry-After تخبرك بعدد الثواني للانتظار.
محاولات دخول كثيرة
HTTP 429
الرسالة
Too many session requests. Please try again later.
متى يظهر
محاولات دخول كثيرة (الحد: 10 في الدقيقة).
ماذا تفعل
انتظر دقيقة واحدة قبل محاولة تسجيل الدخول مجدداً.
محاولات تسجيل كثيرة
HTTP 429
الرسالة
Too many registration attempts. Please try again later.
متى يظهر
محاولات تسجيل كثيرة (الحد: 5 في الدقيقة).
ماذا تفعل
انتظر دقيقة واحدة قبل محاولة التسجيل مجدداً.
محاولات تحقق كثيرة
HTTP 429
متى يظهر
طلبات تحقق بريد أو إعادة تعيين كلمة مرور كثيرة.
ماذا تفعل
تحقق من تفاصيل الخطأ لمعرفة وقت next_attempt_at وانتظر حتى ذلك الوقت.
أخطاء التحقق(5)
حقل مطلوب مفقود
HTTP 400
الرسالة
Missing required field: {field_name}
متى يظهر
لم يتم توفير حقل مطلوب.
ماذا تفعل
املأ جميع الحقول المطلوبة وحاول مجدداً.
بيانات طلب غير صالحة
HTTP 400 / 422
متى يظهر
البيانات المقدّمة لا تتطابق مع الصيغة المتوقعة.
ماذا تفعل
تحقق من مصفوفة errors في الاستجابة لمعرفة المشاكل. صحّح الحقول المشار إليها وأعد الإرسال.
صيغة تاريخ غير صالحة
HTTP 400
الرسالة
Invalid date format. Please use YYYY-MM-DD.
متى يظهر
حقل التاريخ بصيغة خاطئة.
ماذا تفعل
استخدم الصيغة YYYY-MM-DD (مثال: 2025-01-15).
نوع موافقة غير صالح
HTTP 400
الرسالة
Invalid consent type: {type}
متى يظهر
تم تحديد نوع موافقة غير معروف.
ماذا تفعل
هذا عادةً خطأ في التطبيق. حدّث التطبيق لآخر إصدار.
مستوى أمان غير صالح
HTTP 400
الرسالة
Invalid safety_level. Allowed values: low, medium, high.
متى يظهر
تم إرسال رسالة محادثة بمستوى أمان غير صالح.
ماذا تفعل
حدّث التطبيق لآخر إصدار.
أخطاء عدم العثور(8)
المحادثة غير موجودة
HTTP 404
الرسالة
Conversation {id} not found
متى يظهر
المحادثة محذوفة أو غير موجودة.
ماذا تفعل
ابدأ محادثة جديدة. المحادثات القديمة قد تكون حُذفت تلقائياً.
السجل الصحي غير موجود
HTTP 404
متى يظهر
تحاول عرض أو تعديل سجل صحي محذوف أو غير موجود.
ماذا تفعل
ارجع وحدّث القائمة. قد يكون السجل حُذف من جهاز آخر.
الرؤية/الشذوذ غير موجود
HTTP 404
متى يظهر
الرؤية الصحية أو الشذوذ أُزيل أو انتهت صلاحيته.
ماذا تفعل
حدّث لوحة التحكم الصحية لرؤية الرؤى الحالية.
الوجبة غير موجودة
HTTP 404
الرسالة
Meal not found
متى يظهر
إدخال الوجبة محذوف أو غير موجود.
ماذا تفعل
ارجع إلى سجل الوجبات وحدّثه.
الملف غير موجود
HTTP 404
الرسالة
File not found: {file_id}
متى يظهر
الملف المرفوع محذوف أو غير موجود.
ماذا تفعل
أعد رفع الملف إذا لزم الأمر.
انتهت صلاحية الإجراء
HTTP 404
الرسالة
Action not found or expired. Please try again.
متى يظهر
انتهت مهلة تأكيد الإجراء الصحي.
ماذا تفعل
اطلب من مرا تنفيذ الإجراء مجدداً في المحادثة. تأكيدات الإجراءات تنتهي بعد دقائق قليلة.
المشاركة غير موجودة
HTTP 404
الرسالة
Share not found
متى يظهر
رابط مشاركة البيانات الصحية غير صالح أو منتهي.
ماذا تفعل
اطلب من الشخص الذي شارك إنشاء رابط مشاركة جديد.
لا توجد بيانات للتصدير
HTTP 404
الرسالة
No data available for export
متى يظهر
حاولت تصدير بيانات صحية لكن لا توجد سجلات.
ماذا تفعل
أضف بيانات صحية أولاً (مؤشرات حيوية، أدوية، إلخ) قبل التصدير.
أخطاء المحادثة(2)
خدمة الذكاء الاصطناعي غير متوفرة
HTTP 503
الرسالة
AI service temporarily unavailable
متى يظهر
خدمة الذكاء الاصطناعي متوقفة مؤقتاً.
ماذا تفعل
انتظر بضع دقائق وحاول مجدداً. إذا استمرت لأكثر من 30 دقيقة، تحقق من صفحة حالة مرا أو تواصل مع الدعم.
خدمة تأكيد الإجراءات غير متوفرة
HTTP 503
الرسالة
Action confirmation service temporarily unavailable
متى يظهر
خدمة تأكيد الإجراءات الصحية متوقفة.
ماذا تفعل
انتظر بضع دقائق وحاول مجدداً. يمكنك أيضاً تنفيذ الإجراء يدوياً من تبويب الصحة.
أخطاء البيانات الصحية(7)
بيانات حل الأعراض غير صالحة
HTTP 400
الرسالة
Invalid symptom resolution data
متى يظهر
بيانات حل العَرَض غير مكتملة أو مشوّهة.
ماذا تفعل
حاول حل العَرَض مجدداً. تأكد من ملء جميع الحقول بشكل صحيح.
لا يمكن ربط المؤشر بنفسه
HTTP 400
الرسالة
Cannot correlate a vital type with itself
متى يظهر
حاولت رؤية الارتباط بين نفس نوع المؤشر الحيوي.
ماذا تفعل
اختر نوعين مختلفين من المؤشرات الحيوية لتحليل الارتباط.
لا توجد بيانات مؤشرات حيوية
HTTP 400
الرسالة
No vital signs data available for analysis
متى يظهر
لا توجد بيانات كافية لتوليد رؤى.
ماذا تفعل
سجّل المزيد من بيانات المؤشرات الحيوية على مدى أيام، ثم حاول مجدداً.
تعذّر حساب الارتباط/التوزيع
HTTP 400
متى يظهر
نقاط بيانات غير كافية للتحليل الإحصائي.
ماذا تفعل
استمر بتسجيل المؤشرات الحيوية لمدة 7 أيام على الأقل لبناء بيانات كافية للتحليل.
لا توجد بيانات لهذا المؤشر
HTTP 404
الرسالة
No data available for this vital type
متى يظهر
لا توجد سجلات للمؤشر الحيوي المختار.
ماذا تفعل
ابدأ بتسجيل بيانات هذا المؤشر من تبويب الصحة أو بالمزامنة من Apple Health / Health Connect.
حد استيراد المؤشرات
HTTP 400
الرسالة
Maximum 1000 vitals per import request
متى يظهر
تحاول استيراد مؤشرات حيوية كثيرة دفعة واحدة.
ماذا تفعل
قسّم الاستيراد إلى دفعات من 1000 سجل أو أقل.
لم يتم توفير مؤشرات
HTTP 400
الرسالة
No vitals provided for import
متى يظهر
طلب الاستيراد فارغ.
ماذا تفعل
تأكد من أن بيانات الاستيراد تحتوي على سجل مؤشر حيوي واحد على الأقل.
أخطاء الطعام والتغذية(9)
باركود غير صالح
HTTP 400
الرسالة
Invalid barcode format. Please check your input.
متى يظهر
الباركود الممسوح بصيغة غير معروفة.
ماذا تفعل
حاول مسح الباركود مجدداً. تأكد من أنه نظيف ومُضاء جيداً وغير تالف.
معايير بحث غير صالحة
HTTP 400
الرسالة
Invalid search parameters. Please check your input.
متى يظهر
استعلام البحث عن الطعام فارغ أو مشوّه.
ماذا تفعل
أدخل اسم طعام أو وصفاً صالحاً وحاول مجدداً.
بيانات صورة غير صالحة
HTTP 400
الرسالة
Invalid image data. Please check your input.
متى يظهر
الصورة المرسلة لتحليل الطعام تالفة أو غير صالحة.
ماذا تفعل
التقط صورة جديدة وحاول مجدداً. تأكد من وضوح الصورة.
نوع صورة غير صالح
HTTP 400
الرسالة
Invalid file type. Only JPEG and PNG images are supported.
متى يظهر
رفعت ملفاً ليس صورة لتحليل الطعام.
ماذا تفعل
استخدم صورة بصيغة JPEG أو PNG.
نص إدخال غير صالح
HTTP 400
الرسالة
Invalid text input. Please check your input.
متى يظهر
النص المرسل لتحليل الطعام فارغ أو غير صالح.
ماذا تفعل
صِف الطعام بوضوح وحاول مجدداً.
خطأ داخلي في خدمة الطعام
HTTP 500
متى يظهر
واجهت خدمة الطعام خطأ داخلياً (بحث باركود، بحث طعام، تحليل صور، تحليل نصوص، أو بحث مطاعم).
ماذا تفعل
انتظر قليلاً وحاول مجدداً. إذا استمر، قد تكون خدمة الطعام متوقفة مؤقتاً.
خدمة الطعام غير متوفرة
HTTP 503
الرسالة
Service temporarily unavailable
متى يظهر
قاعدة بيانات الطعام أو خدمة التحليل متوقفة.
ماذا تفعل
حاول مجدداً بعد بضع دقائق. يمكنك تسجيل الأطعمة يدوياً في هذه الأثناء.
أخطاء المفضلة/الأهداف
HTTP 500
متى يظهر
خطأ في قاعدة البيانات أثناء إدارة تفضيلات الطعام (المفضلة أو الأهداف أو التقدم اليومي).
ماذا تفعل
انتظر وحاول مجدداً. إذا استمر، جرّب تسجيل الخروج والدخول مجدداً.
المفضلة غير موجودة
HTTP 404
الرسالة
Favorite not found
متى يظهر
تحاول إزالة مفضلة لم تعد موجودة.
ماذا تفعل
حدّث قائمة المفضلة. قد يكون العنصر أُزيل بالفعل.
أخطاء رفع الملفات(8)
الملف كبير جداً
HTTP 400 / 413
الرسالة
File too large. Max size: 10MB.
متى يظهر
الملف المرفوع يتجاوز حد 10 ميغابايت.
ماذا تفعل
اضغط الملف أو استخدم نسخة أصغر. للصور، قلّل الدقة. لملفات PDF، استخدم ضاغط PDF.
نوع ملف غير مدعوم
HTTP 400
الرسالة
Unsupported file type. Allowed: PDF, JPEG, PNG, FHIR JSON, CCDA XML
متى يظهر
رفعت ملفاً بصيغة غير مدعومة.
ماذا تفعل
حوّل الملف لأحد الصيغ المدعومة: PDF، JPEG، PNG، FHIR JSON، أو CCDA XML.
فشل قراءة الملف
HTTP 400
الرسالة
Failed to read file content
متى يظهر
الملف تالف أو لا يمكن قراءته.
ماذا تفعل
حاول رفع الملف مجدداً. إذا استمر، جرّب نسخة أخرى من الملف.
فشل الرفع إلى التخزين
HTTP 500
الرسالة
Failed to upload file to storage
متى يظهر
خطأ في التخزين من جانب الخادم.
ماذا تفعل
انتظر وحاول مجدداً. إذا استمر، تواصل مع الدعم.
الملف محذوف بالفعل
HTTP 410
الرسالة
File already deleted
متى يظهر
تحاول حذف ملف أُزيل بالفعل.
ماذا تفعل
لا حاجة لأي إجراء — الملف محذوف فعلاً. حدّث قائمة الملفات.
الملف محذوف نهائياً
HTTP 410
الرسالة
File has been permanently deleted from storage
متى يظهر
تحاول تنزيل ملف حُذف نهائياً.
ماذا تفعل
لا يمكن استعادة الملف. أعد رفعه إذا كان لديك نسخة.
الملف غير محذوف (لا يمكن الاستعادة)
HTTP 400
الرسالة
File is not deleted, cannot restore
متى يظهر
تحاول استعادة ملف ليس في سلة المحذوفات.
ماذا تفعل
الملف متاح بالفعل — لا حاجة للاستعادة.
فلتر حالة غير صالح
HTTP 400
الرسالة
Invalid status filter. Valid values: uploaded, processed, failed, deleted
متى يظهر
معيار فلترة قائمة الملفات غير صالح.
ماذا تفعل
استخدم أحد القيم: uploaded, processed, failed, deleted.
أخطاء الأجهزة(1)
فشل حفظ/حذف رمز FCM
HTTP 500
متى يظهر
فشل تسجيل الإشعارات الفورية.
ماذا تفعل
أعد تشغيل التطبيق. إذا لم تصلك إشعارات، اذهب إلى الإعدادات > الإشعارات وأعد تفعيلها.
أخطاء الدفع والاشتراك(1)
الاشتراك لا يتحدّث
متى يظهر
اشتريت أو ألغيت بريميوم لكن التطبيق لم يعكس ذلك.
ماذا تفعل
1. أغلق التطبيق وأعد فتحه. 2. اذهب إلى الإعدادات > الاشتراك واسحب للتحديث. 3. إذا لم يتحدث بعد 5 دقائق، تواصل مع الدعم مع إيصال الشراء.
أخطاء الخادم(4)
خطأ خادم داخلي
HTTP 500
الرسالة
An internal server error occurred
متى يظهر
حدث خطأ غير متوقع في الخادم.
ماذا تفعل
انتظر قليلاً وحاول مجدداً. إذا استمر، تواصل مع الدعم مع correlation_id من استجابة الخطأ (إن كان ظاهراً).
قاعدة البيانات غير متوفرة
HTTP 503
متى يظهر
قاعدة البيانات متوقفة أو غير قابلة للوصول.
ماذا تفعل
انتظر 30 ثانية وحاول مجدداً. هذه عادةً مشكلة بنية تحتية مؤقتة.
خدمة المصادقة غير متوفرة
HTTP 503
الرسالة
Authentication service is temporarily unavailable.
متى يظهر
خدمة مصادقة Firebase متوقفة مؤقتاً.
ماذا تفعل
انتظر بضع دقائق. تُحل عادةً خلال 5–10 دقائق.
فشل تهيئة الأمان
HTTP 500
الرسالة
Security initialization failed.
متى يظهر
فشلت تهيئة أمان قاعدة البيانات بعد تسجيل الدخول.
ماذا تفعل
حاول تسجيل الدخول مجدداً. إذا استمر، تواصل مع الدعم.
أخطاء انتهاء المهلة(2)
انتهاء مهلة الخدمة
HTTP 504
متى يظهر
استغرق الطلب وقتاً طويلاً للمعالجة (خدمة، بحث، تحليل صور، تحليل نصوص، أو قاعدة بيانات).
ماذا تفعل
أعد المحاولة. إذا كنت على شبكة بطيئة، انتظر اتصالاً أفضل. لتحليل الصور، جرّب صورة أصغر.
انتهاء مهلة الطلب
HTTP 504
الرسالة
Request timed out after {X} seconds
متى يظهر
لم يستجب الخادم في الوقت المحدد.
ماذا تفعل
تحقق من اتصالك بالإنترنت وحاول مجدداً.
أخطاء الشبكة والاتصال(4)
لا يوجد اتصال بالإنترنت
متى يظهر
جهازك غير متصل بالإنترنت.
ماذا تفعل
تحقق من WiFi أو بيانات الهاتف. حاول فتح صفحة ويب في المتصفح لتأكيد الاتصال.
انتهت مهلة الاتصال
متى يظهر
الخادم غير قابل للوصول.
ماذا تفعل
1. تحقق من الإنترنت. 2. انتظر قليلاً وحاول مجدداً. 3. إذا كنت تستخدم VPN، جرّب تعطيله.
خطأ SSL/الشهادة
متى يظهر
تعذّر إنشاء اتصال آمن.
ماذا تفعل
تأكد من صحة التاريخ والوقت على جهازك. حدّث التطبيق لآخر إصدار.
خطأ في المقبس
متى يظهر
انقطع الاتصال بالشبكة.
ماذا تفعل
أعد المحاولة. انتقل لمنطقة ذات إشارة أفضل إذا كنت تستخدم بيانات الهاتف.
Authentication Errors(5)
Invalid or expired token
HTTP 401
WHEN
Your login session has expired or the token is invalid.
WHAT TO DO
Close the app and sign in again. If it persists, sign out completely and sign back in.
Email not verified
HTTP 401
MESSAGE
Email not verified. Please verify your email address.
WHEN
You signed up but haven't verified your email.
WHAT TO DO
Check your inbox (and spam folder) for the verification email. Click the link, then try logging in again. You can request a new verification email from the login screen.
Account deactivated
HTTP 401
MESSAGE
Account is deactivated. Please contact support.
WHEN
Your account has been disabled by an administrator.
WHAT TO DO
Contact Mara support at support@mara.health to reactivate your account.
User not found
HTTP 401
MESSAGE
User not found. Please register first.
WHEN
Trying to log in with an account that doesn't exist.
WHAT TO DO
Create a new account using the Sign Up flow. If you believe you already have an account, make sure you're using the correct email address.
Missing authorization
HTTP 401
WHEN
The app failed to send your authentication token.
WHAT TO DO
Sign out and sign back in. If the problem continues, clear app data and reinstall.
Authorization Errors(5)
Device limit exceeded
HTTP 403DEVICE_LIMIT_EXCEEDED
WHEN
You've reached the maximum number of devices for your plan.
WHAT TO DO
Free plan: 1 device. Premium: 3 devices. Go to Settings > Devices and remove an old device, or upgrade to Premium.
Premium subscription required
HTTP 403
MESSAGE
This feature requires a premium subscription
WHEN
You tried to use a Premium-only feature.
WHAT TO DO
Upgrade to Mara Premium from Settings > Subscription.
Access denied
HTTP 403
MESSAGE
Access denied
WHEN
You don't have permission for this action.
WHAT TO DO
Make sure you're logged into the correct account. Some features require specific roles or consents.
Consent required
HTTP 403
WHEN
You need to grant consent before accessing health-related features.
WHAT TO DO
Go to Settings > Privacy & Consent and accept the required consent.
Not authorized for this action
HTTP 403
MESSAGE
You are not authorized to confirm this action.
WHEN
Trying to confirm a health action that belongs to another user.
WHAT TO DO
Make sure you're logged into the correct account.
Account Conflicts(2)
Email/UID conflict
HTTP 409EMAIL_UID_CONFLICT
WHEN
Your Firebase account was recreated but the database still has the old account link.
WHAT TO DO
In most cases, this resolves automatically on your next login attempt. If you keep seeing this error, contact support with your email address.
User already exists
HTTP 409
MESSAGE
User already exists.
WHEN
Trying to register with an email that already has an account.
WHAT TO DO
Use the Login screen instead. If you forgot your password, use "Forgot Password" to reset it.
Rate Limiting(4)
Too many requests
HTTP 429
MESSAGE
Rate limit exceeded. Please try again later.
WHEN
You've sent too many requests in a short time.
WHAT TO DO
Wait a moment and try again. The Retry-After header tells you how many seconds to wait.
Too many login attempts
HTTP 429
MESSAGE
Too many session requests. Please try again later.
WHEN
Too many login attempts (limit: 10/minute).
WHAT TO DO
Wait 1 minute before trying to log in again.
Too many registration attempts
HTTP 429
MESSAGE
Too many registration attempts. Please try again later.
WHEN
Too many sign-up attempts (limit: 5/minute).
WHAT TO DO
Wait 1 minute before trying to register again.
Too many verification attempts
HTTP 429
WHEN
Too many email verification or password reset requests.
WHAT TO DO
Check the error details for the next_attempt_at time and wait until then.
Validation Errors(5)
Missing required field
HTTP 400
MESSAGE
Missing required field: {field_name}
WHEN
A required field was not provided.
WHAT TO DO
Fill in all required fields and try again. Check that device_id, email, or other required data is being sent.
Invalid request data
HTTP 400 / 422
WHEN
The data you submitted doesn't match the expected format.
WHAT TO DO
Check the errors array in the response for specific field issues. Correct the highlighted fields and resubmit.
Invalid date format
HTTP 400
MESSAGE
Invalid date format. Please use YYYY-MM-DD.
WHEN
A date field has the wrong format.
WHAT TO DO
Use the format YYYY-MM-DD (e.g., 2025-01-15).
Invalid consent type
HTTP 400
MESSAGE
Invalid consent type: {type}
WHEN
An unrecognized consent type was specified.
WHAT TO DO
This is usually an app bug. Update the app to the latest version.
Invalid safety level
HTTP 400
MESSAGE
Invalid safety_level. Allowed values: low, medium, high.
WHEN
Chat message sent with invalid safety level.
WHAT TO DO
Update the app to the latest version.
Not Found Errors(8)
Conversation not found
HTTP 404
MESSAGE
Conversation {id} not found
WHEN
The conversation was deleted or doesn't exist.
WHAT TO DO
Start a new conversation. Old conversations may have been cleaned up.
Health record not found
HTTP 404
WHEN
Trying to view or edit a health record that was deleted or doesn't exist.
WHAT TO DO
Go back and refresh the list. The record may have been deleted from another device.
Insight/Anomaly not found
HTTP 404
WHEN
The health insight or anomaly was removed or expired.
WHAT TO DO
Refresh your health dashboard to see current insights.
Meal not found
HTTP 404
MESSAGE
Meal not found
WHEN
The meal entry was deleted or doesn't exist.
WHAT TO DO
Go back to your meal history and refresh.
File not found
HTTP 404
MESSAGE
File not found: {file_id}
WHEN
The uploaded file was deleted or doesn't exist.
WHAT TO DO
Re-upload the file if needed.
Action expired
HTTP 404
MESSAGE
Action not found or expired. Please try again.
WHEN
A health action confirmation timed out.
WHAT TO DO
Ask Mara to perform the action again in chat. Action confirmations expire after a few minutes.
Share not found
HTTP 404
MESSAGE
Share not found
WHEN
The health data share link is invalid or expired.
WHAT TO DO
Ask the person who shared to create a new share link.
No data available for export
HTTP 404
MESSAGE
No data available for export
WHEN
You tried to export health data but have no records.
WHAT TO DO
Add health data first (vitals, medications, etc.) before exporting.
Chat Errors(2)
AI service unavailable
HTTP 503
MESSAGE
AI service temporarily unavailable
WHEN
The AI backend is temporarily down.
WHAT TO DO
Wait a few minutes and try again. If it persists for more than 30 minutes, check Mara status page or contact support.
Action confirmation unavailable
HTTP 503
MESSAGE
Action confirmation service temporarily unavailable
WHEN
The service that handles health action confirmations is down.
WHAT TO DO
Wait a few minutes and try the action again. You can also perform the action manually from the Health tab.
Health Data Errors(7)
Invalid symptom resolution data
HTTP 400
MESSAGE
Invalid symptom resolution data
WHEN
The data for resolving a symptom is incomplete or malformed.
WHAT TO DO
Try resolving the symptom again. Make sure all fields are filled correctly.
Cannot correlate vital with itself
HTTP 400
MESSAGE
Cannot correlate a vital type with itself
WHEN
You tried to see correlation between the same vital type.
WHAT TO DO
Select two different vital types for correlation analysis.
No vital signs data available
HTTP 400
MESSAGE
No vital signs data available for analysis
WHEN
Not enough data to generate insights.
WHAT TO DO
Log more vital signs data over a few days, then try again.
Unable to calculate correlation/distribution
HTTP 400
WHEN
Insufficient data points for statistical analysis.
WHAT TO DO
Keep logging vitals for at least 7 days to build enough data for analysis.
No data available for vital type
HTTP 404
MESSAGE
No data available for this vital type
WHEN
No records exist for the selected vital type.
WHAT TO DO
Start logging data for this vital type from the Health tab or by syncing from Apple Health / Health Connect.
Vitals import limit
HTTP 400
MESSAGE
Maximum 1000 vitals per import request
WHEN
Trying to import too many vitals at once.
WHAT TO DO
Split your import into batches of 1000 or fewer records.
No vitals provided
HTTP 400
MESSAGE
No vitals provided for import
WHEN
Import request was empty.
WHAT TO DO
Make sure your import data contains at least one vital sign record.
Food & Nutrition Errors(9)
Invalid barcode
HTTP 400
MESSAGE
Invalid barcode format. Please check your input.
WHEN
The scanned barcode is not in a recognized format.
WHAT TO DO
Try scanning the barcode again. Make sure the barcode is clean, well-lit, and not damaged.
Invalid search parameters
HTTP 400
MESSAGE
Invalid search parameters. Please check your input.
WHEN
Food search query is empty or malformed.
WHAT TO DO
Enter a valid food name or description and try again.
Invalid image data
HTTP 400
MESSAGE
Invalid image data. Please check your input.
WHEN
The image sent for food analysis is corrupted or invalid.
WHAT TO DO
Take a new photo and try again. Make sure the image is clear.
Invalid image type
HTTP 400
MESSAGE
Invalid file type. Only JPEG and PNG images are supported.
WHEN
You uploaded a non-image file for food analysis.
WHAT TO DO
Use a JPEG or PNG image.
Invalid text input
HTTP 400
MESSAGE
Invalid text input. Please check your input.
WHEN
Text sent for food parsing is empty or invalid.
WHAT TO DO
Describe the food item clearly and try again.
Food service internal error
HTTP 500
WHEN
The food service encountered an internal error (barcode lookup, food search, image analysis, text parsing, or restaurant search).
WHAT TO DO
Wait a moment and try again. If it keeps happening, the food service may be temporarily down.
Food service unavailable
HTTP 503
MESSAGE
Service temporarily unavailable
WHEN
The food database or analysis service is down.
WHAT TO DO
Try again in a few minutes. You can manually log food items in the meantime.
Favorites/Goals errors
HTTP 500
WHEN
Database error while managing food preferences (get/add/remove favorites, get/update goals, get daily progress).
WHAT TO DO
Wait and retry. If persistent, try signing out and back in.
Favorite not found
HTTP 404
MESSAGE
Favorite not found
WHEN
Trying to remove a favorite that no longer exists.
WHAT TO DO
Refresh your favorites list. The item may have already been removed.
File Upload Errors(8)
File too large
HTTP 400 / 413
MESSAGE
File too large. Max size: 10MB.
WHEN
The uploaded file exceeds the 10MB limit.
WHAT TO DO
Compress the file or use a smaller version. For images, reduce resolution. For PDFs, use a PDF compressor.
Unsupported file type
HTTP 400
MESSAGE
Unsupported file type. Allowed: PDF, JPEG, PNG, FHIR JSON, CCDA XML
WHEN
You uploaded a file in an unsupported format.
WHAT TO DO
Convert the file to one of the supported formats: PDF, JPEG, PNG, FHIR JSON, or CCDA XML.
Failed to read file
HTTP 400
MESSAGE
Failed to read file content
WHEN
The file is corrupted or couldn't be read.
WHAT TO DO
Try uploading the file again. If it persists, try a different copy of the file.
Failed to upload to storage
HTTP 500
MESSAGE
Failed to upload file to storage
WHEN
Server-side storage error.
WHAT TO DO
Wait and retry. If persistent, contact support.
File already deleted
HTTP 410
MESSAGE
File already deleted
WHEN
Trying to delete a file that's already been removed.
WHAT TO DO
No action needed — the file is already gone. Refresh the file list.
File permanently deleted
HTTP 410
MESSAGE
File has been permanently deleted from storage
WHEN
Trying to download a file that was permanently removed.
WHAT TO DO
The file can't be recovered. Re-upload if you have a copy.
File not deleted (can't restore)
HTTP 400
MESSAGE
File is not deleted, cannot restore
WHEN
Trying to restore a file that isn't in the trash.
WHAT TO DO
The file is already available — no restore needed.
Invalid status filter
HTTP 400
MESSAGE
Invalid status filter. Valid values: uploaded, processed, failed, deleted
WHEN
Invalid file list filter parameter.
WHAT TO DO
Use one of: uploaded, processed, failed, deleted.
Device Errors(1)
Failed to save/delete FCM token
HTTP 500
WHEN
Push notification registration failed.
WHAT TO DO
Restart the app. If you're not getting notifications, go to Settings > Notifications and re-enable them.
Payment & Subscription Errors(1)
Subscription not updating
WHEN
You purchased/cancelled Premium but the app doesn't reflect it.
WHAT TO DO
1. Close and reopen the app. 2. Go to Settings > Subscription and pull to refresh. 3. If it still doesn't update after 5 minutes, contact support with your purchase receipt.
Server Errors(4)
Internal server error
HTTP 500
MESSAGE
An internal server error occurred
WHEN
Something unexpected went wrong on the server.
WHAT TO DO
Wait a moment and try again. If persistent, contact support with the correlation_id from the error response (if visible).
Database unavailable
HTTP 503
WHEN
The database is down or unreachable.
WHAT TO DO
Wait 30 seconds and retry. This is usually a temporary infrastructure issue.
Authentication service unavailable
HTTP 503
MESSAGE
Authentication service is temporarily unavailable.
WHEN
Firebase authentication is temporarily down.
WHAT TO DO
Wait a few minutes. This usually resolves within 5–10 minutes.
Security initialization failed
HTTP 500
MESSAGE
Security initialization failed.
WHEN
Database security setup failed after login.
WHAT TO DO
Try logging in again. If persistent, contact support.
Timeout Errors(2)
Service timeout
HTTP 504
WHEN
A request took too long to process (service, search, image analysis, text parsing, or database timeout).
WHAT TO DO
Retry the action. If on a slow network, wait for better connectivity. For image analysis, try with a smaller image.
Request timeout
HTTP 504
MESSAGE
Request timed out after {X} seconds
WHEN
The server didn't respond in time.
WHAT TO DO
Check your internet connection and try again.
Network & Connectivity Errors(4)
No internet connection
WHEN
Your device has no internet access.
WHAT TO DO
Check your WiFi or cellular data. Try opening a web page in your browser to confirm connectivity.
Connection timed out
WHEN
The server is unreachable.
WHAT TO DO
1. Check your internet. 2. Wait a moment and retry. 3. If using VPN, try disabling it.
SSL/Certificate error
WHEN
Secure connection couldn't be established.
WHAT TO DO
Make sure your device date/time is correct. Update the app to the latest version.
Socket exception
WHEN
Network connection was interrupted.
WHAT TO DO
Retry the action. Move to an area with better signal if on mobile data.
?
لا توجد نتائج مطابقة.
جرّب كلمات مختلفة أو تصفّح الأقسام أدناه.

استكشاف الأخطاء العام

إذا واجهت خطأ غير مذكور هنا، جرّب هذه الخطوات بالترتيب:

  1. أعد المحاولة — كثير من الأخطاء مؤقتة. انتظر ثوانٍ وحاول مجدداً.
  2. أعد تشغيل التطبيق — أغلقه تماماً ثم افتحه من جديد.
  3. تحقق من الإنترنت — تأكد من اتصالك بشبكة مستقرة.
  4. حدّث التطبيق — ثبّت آخر إصدار من App Store أو Play Store.
  5. سجّل خروج ثم دخول — اذهب إلى الإعدادات > تسجيل الخروج، ثم سجّل دخولك مجدداً.
  6. امسح بيانات التطبيق — كحل أخير، احذف التطبيق وأعد تثبيته (بياناتك محفوظة على الخادم).
  7. تواصل مع الدعم — أرسل بريداً إلى support@mara.health مع بريدك الإلكتروني، رسالة الخطأ (لقطة شاشة إن أمكن)، correlation_id (إن ظهر)، وما كنت تفعله عند حدوث الخطأ.
  8. Retry — Many errors are temporary. Wait a few seconds and try again.
  9. Restart the app — Force close and reopen Mara.
  10. Check internet — Make sure you have a stable connection.
  11. Update the app — Install the latest version from the App Store / Play Store.
  12. Sign out and back in — Go to Settings > Sign Out, then log in again.
  13. Clear app data — As a last resort, uninstall and reinstall the app (your data is saved on the server).
  14. Contact support — Email support@mara.health with your email address, the error message (screenshot if possible), the correlation_id (if shown), and what you were doing when the error occurred.
للمطورين: صيغة الأخطاء التقنية

جميع أخطاء API تتبع هذه الصيغة:

{
  "error": {
    "code": 400,
    "message": "Human-readable error description",
    "type": "invalid_request_error",
    "reason": "SPECIFIC_ERROR_CODE",
    "path": "/api/v1/endpoint",
    "correlation_id": "tracking-uuid"
  }
}
النوعالمعنى
invalid_request_error (400)بيانات إدخال غير صالحة
authentication_error (401)غير مسجّل الدخول أو انتهت صلاحية الرمز
authorization_error (403)لا توجد صلاحية لهذا الإجراء
not_found_error (404)المورد غير موجود
conflict_error (409)تعارض في الموارد
rate_limit_error (429)طلبات كثيرة جداً
internal_server_error (500)خطأ في الخادم
service_unavailable_error (503)الخدمة متوقفة مؤقتاً
TypeMeaning
invalid_request_error (400)Bad input data
authentication_error (401)Not logged in or token expired
authorization_error (403)No permission for this action
not_found_error (404)Resource doesn't exist
conflict_error (409)Resource conflict
rate_limit_error (429)Too many requests
internal_server_error (500)Server bug
service_unavailable_error (503)Service temporarily down

لم تجد الحل؟ فريق الدعم مستعد لمساعدتك.

support@iammara.com
← العودة للرئيسية