مرجع الأخطاء
دليل شامل لكل خطأ قد يظهر في تطبيق مرا — ما يعنيه وكيفية حلّه.
67 خطأ في 15 قسم67 errors across 15 categories
أخطاء المصادقة(5)
رمز غير صالح أو منتهي الصلاحية
متى يظهر
انتهت جلسة تسجيل الدخول أو أن الرمز غير صالح.
ماذا تفعل
أغلق التطبيق وسجّل دخولك مجدداً. إذا استمرت المشكلة، سجّل خروج كاملاً ثم أعد تسجيل الدخول.
البريد الإلكتروني غير مُحقّق
الرسالة
متى يظهر
سجّلت حساباً لكن لم تُحقّق بريدك الإلكتروني.
ماذا تفعل
تحقق من بريدك الوارد (ومجلد الرسائل غير المرغوبة) بحثاً عن رسالة التحقق. اضغط الرابط، ثم حاول تسجيل الدخول مجدداً. يمكنك طلب رسالة تحقق جديدة من شاشة الدخول.
الحساب معطّل
الرسالة
متى يظهر
تم تعطيل حسابك من قبل المسؤول.
ماذا تفعل
تواصل مع دعم مرا على support@mara.health لإعادة تفعيل حسابك.
المستخدم غير موجود
الرسالة
متى يظهر
تحاول تسجيل الدخول بحساب غير مسجّل.
ماذا تفعل
أنشئ حساباً جديداً. إذا كنت تعتقد أن لديك حساباً بالفعل، تأكد من استخدام البريد الإلكتروني الصحيح.
تفويض مفقود
متى يظهر
فشل التطبيق في إرسال رمز المصادقة.
ماذا تفعل
سجّل خروج ثم أعد تسجيل الدخول. إذا استمرت المشكلة، امسح بيانات التطبيق وأعد تثبيته.
أخطاء الصلاحيات(5)
تجاوز حد الأجهزة
متى يظهر
وصلت الحد الأقصى لعدد الأجهزة في خطتك.
ماذا تفعل
الخطة المجانية: جهاز واحد. بريميوم: 3 أجهزة. اذهب إلى الإعدادات > الأجهزة واحذف جهازاً قديماً، أو قم بالترقية إلى بريميوم.
يتطلب اشتراك بريميوم
الرسالة
متى يظهر
حاولت استخدام ميزة متاحة فقط لمشتركي بريميوم.
ماذا تفعل
قم بالترقية إلى مرا بريميوم من الإعدادات > الاشتراك.
الوصول مرفوض
الرسالة
متى يظهر
ليس لديك صلاحية لهذا الإجراء.
ماذا تفعل
تأكد من تسجيل دخولك بالحساب الصحيح. بعض الميزات تتطلب أدواراً أو موافقات محددة.
الموافقة مطلوبة
متى يظهر
تحتاج لمنح الموافقة قبل الوصول للميزات الصحية.
ماذا تفعل
اذهب إلى الإعدادات > الخصوصية والموافقات واقبل الموافقة المطلوبة.
غير مصرّح بهذا الإجراء
الرسالة
متى يظهر
تحاول تأكيد إجراء صحي يخص مستخدماً آخر.
ماذا تفعل
تأكد من تسجيل دخولك بالحساب الصحيح.
تعارضات الحساب(2)
تعارض البريد/المعرّف
متى يظهر
تم إعادة إنشاء حسابك في Firebase لكن قاعدة البيانات لا تزال مرتبطة بالحساب القديم.
ماذا تفعل
في معظم الحالات، يُحل تلقائياً عند محاولة الدخول التالية. إذا استمر الخطأ، تواصل مع الدعم مع بريدك الإلكتروني.
المستخدم موجود بالفعل
الرسالة
متى يظهر
تحاول التسجيل ببريد إلكتروني لديه حساب بالفعل.
ماذا تفعل
استخدم شاشة تسجيل الدخول. إذا نسيت كلمة المرور، استخدم "نسيت كلمة المرور" لإعادة تعيينها.
تحديد المعدل(4)
طلبات كثيرة جداً
الرسالة
متى يظهر
أرسلت طلبات كثيرة في وقت قصير.
ماذا تفعل
انتظر قليلاً وحاول مجدداً. ترويسة Retry-After تخبرك بعدد الثواني للانتظار.
محاولات دخول كثيرة
الرسالة
متى يظهر
محاولات دخول كثيرة (الحد: 10 في الدقيقة).
ماذا تفعل
انتظر دقيقة واحدة قبل محاولة تسجيل الدخول مجدداً.
محاولات تسجيل كثيرة
الرسالة
متى يظهر
محاولات تسجيل كثيرة (الحد: 5 في الدقيقة).
ماذا تفعل
انتظر دقيقة واحدة قبل محاولة التسجيل مجدداً.
محاولات تحقق كثيرة
متى يظهر
طلبات تحقق بريد أو إعادة تعيين كلمة مرور كثيرة.
ماذا تفعل
تحقق من تفاصيل الخطأ لمعرفة وقت next_attempt_at وانتظر حتى ذلك الوقت.
أخطاء التحقق(5)
حقل مطلوب مفقود
الرسالة
متى يظهر
لم يتم توفير حقل مطلوب.
ماذا تفعل
املأ جميع الحقول المطلوبة وحاول مجدداً.
بيانات طلب غير صالحة
متى يظهر
البيانات المقدّمة لا تتطابق مع الصيغة المتوقعة.
ماذا تفعل
تحقق من مصفوفة errors في الاستجابة لمعرفة المشاكل. صحّح الحقول المشار إليها وأعد الإرسال.
صيغة تاريخ غير صالحة
الرسالة
متى يظهر
حقل التاريخ بصيغة خاطئة.
ماذا تفعل
استخدم الصيغة YYYY-MM-DD (مثال: 2025-01-15).
نوع موافقة غير صالح
الرسالة
متى يظهر
تم تحديد نوع موافقة غير معروف.
ماذا تفعل
هذا عادةً خطأ في التطبيق. حدّث التطبيق لآخر إصدار.
مستوى أمان غير صالح
الرسالة
متى يظهر
تم إرسال رسالة محادثة بمستوى أمان غير صالح.
ماذا تفعل
حدّث التطبيق لآخر إصدار.
أخطاء عدم العثور(8)
المحادثة غير موجودة
الرسالة
متى يظهر
المحادثة محذوفة أو غير موجودة.
ماذا تفعل
ابدأ محادثة جديدة. المحادثات القديمة قد تكون حُذفت تلقائياً.
السجل الصحي غير موجود
متى يظهر
تحاول عرض أو تعديل سجل صحي محذوف أو غير موجود.
ماذا تفعل
ارجع وحدّث القائمة. قد يكون السجل حُذف من جهاز آخر.
الرؤية/الشذوذ غير موجود
متى يظهر
الرؤية الصحية أو الشذوذ أُزيل أو انتهت صلاحيته.
ماذا تفعل
حدّث لوحة التحكم الصحية لرؤية الرؤى الحالية.
الوجبة غير موجودة
الرسالة
متى يظهر
إدخال الوجبة محذوف أو غير موجود.
ماذا تفعل
ارجع إلى سجل الوجبات وحدّثه.
الملف غير موجود
الرسالة
متى يظهر
الملف المرفوع محذوف أو غير موجود.
ماذا تفعل
أعد رفع الملف إذا لزم الأمر.
انتهت صلاحية الإجراء
الرسالة
متى يظهر
انتهت مهلة تأكيد الإجراء الصحي.
ماذا تفعل
اطلب من مرا تنفيذ الإجراء مجدداً في المحادثة. تأكيدات الإجراءات تنتهي بعد دقائق قليلة.
المشاركة غير موجودة
الرسالة
متى يظهر
رابط مشاركة البيانات الصحية غير صالح أو منتهي.
ماذا تفعل
اطلب من الشخص الذي شارك إنشاء رابط مشاركة جديد.
لا توجد بيانات للتصدير
الرسالة
متى يظهر
حاولت تصدير بيانات صحية لكن لا توجد سجلات.
ماذا تفعل
أضف بيانات صحية أولاً (مؤشرات حيوية، أدوية، إلخ) قبل التصدير.
أخطاء المحادثة(2)
خدمة الذكاء الاصطناعي غير متوفرة
الرسالة
متى يظهر
خدمة الذكاء الاصطناعي متوقفة مؤقتاً.
ماذا تفعل
انتظر بضع دقائق وحاول مجدداً. إذا استمرت لأكثر من 30 دقيقة، تحقق من صفحة حالة مرا أو تواصل مع الدعم.
خدمة تأكيد الإجراءات غير متوفرة
الرسالة
متى يظهر
خدمة تأكيد الإجراءات الصحية متوقفة.
ماذا تفعل
انتظر بضع دقائق وحاول مجدداً. يمكنك أيضاً تنفيذ الإجراء يدوياً من تبويب الصحة.
أخطاء البيانات الصحية(7)
بيانات حل الأعراض غير صالحة
الرسالة
متى يظهر
بيانات حل العَرَض غير مكتملة أو مشوّهة.
ماذا تفعل
حاول حل العَرَض مجدداً. تأكد من ملء جميع الحقول بشكل صحيح.
لا يمكن ربط المؤشر بنفسه
الرسالة
متى يظهر
حاولت رؤية الارتباط بين نفس نوع المؤشر الحيوي.
ماذا تفعل
اختر نوعين مختلفين من المؤشرات الحيوية لتحليل الارتباط.
لا توجد بيانات مؤشرات حيوية
الرسالة
متى يظهر
لا توجد بيانات كافية لتوليد رؤى.
ماذا تفعل
سجّل المزيد من بيانات المؤشرات الحيوية على مدى أيام، ثم حاول مجدداً.
تعذّر حساب الارتباط/التوزيع
متى يظهر
نقاط بيانات غير كافية للتحليل الإحصائي.
ماذا تفعل
استمر بتسجيل المؤشرات الحيوية لمدة 7 أيام على الأقل لبناء بيانات كافية للتحليل.
لا توجد بيانات لهذا المؤشر
الرسالة
متى يظهر
لا توجد سجلات للمؤشر الحيوي المختار.
ماذا تفعل
ابدأ بتسجيل بيانات هذا المؤشر من تبويب الصحة أو بالمزامنة من Apple Health / Health Connect.
حد استيراد المؤشرات
الرسالة
متى يظهر
تحاول استيراد مؤشرات حيوية كثيرة دفعة واحدة.
ماذا تفعل
قسّم الاستيراد إلى دفعات من 1000 سجل أو أقل.
لم يتم توفير مؤشرات
الرسالة
متى يظهر
طلب الاستيراد فارغ.
ماذا تفعل
تأكد من أن بيانات الاستيراد تحتوي على سجل مؤشر حيوي واحد على الأقل.
أخطاء الطعام والتغذية(9)
باركود غير صالح
الرسالة
متى يظهر
الباركود الممسوح بصيغة غير معروفة.
ماذا تفعل
حاول مسح الباركود مجدداً. تأكد من أنه نظيف ومُضاء جيداً وغير تالف.
معايير بحث غير صالحة
الرسالة
متى يظهر
استعلام البحث عن الطعام فارغ أو مشوّه.
ماذا تفعل
أدخل اسم طعام أو وصفاً صالحاً وحاول مجدداً.
بيانات صورة غير صالحة
الرسالة
متى يظهر
الصورة المرسلة لتحليل الطعام تالفة أو غير صالحة.
ماذا تفعل
التقط صورة جديدة وحاول مجدداً. تأكد من وضوح الصورة.
نوع صورة غير صالح
الرسالة
متى يظهر
رفعت ملفاً ليس صورة لتحليل الطعام.
ماذا تفعل
استخدم صورة بصيغة JPEG أو PNG.
نص إدخال غير صالح
الرسالة
متى يظهر
النص المرسل لتحليل الطعام فارغ أو غير صالح.
ماذا تفعل
صِف الطعام بوضوح وحاول مجدداً.
خطأ داخلي في خدمة الطعام
متى يظهر
واجهت خدمة الطعام خطأ داخلياً (بحث باركود، بحث طعام، تحليل صور، تحليل نصوص، أو بحث مطاعم).
ماذا تفعل
انتظر قليلاً وحاول مجدداً. إذا استمر، قد تكون خدمة الطعام متوقفة مؤقتاً.
خدمة الطعام غير متوفرة
الرسالة
متى يظهر
قاعدة بيانات الطعام أو خدمة التحليل متوقفة.
ماذا تفعل
حاول مجدداً بعد بضع دقائق. يمكنك تسجيل الأطعمة يدوياً في هذه الأثناء.
أخطاء المفضلة/الأهداف
متى يظهر
خطأ في قاعدة البيانات أثناء إدارة تفضيلات الطعام (المفضلة أو الأهداف أو التقدم اليومي).
ماذا تفعل
انتظر وحاول مجدداً. إذا استمر، جرّب تسجيل الخروج والدخول مجدداً.
المفضلة غير موجودة
الرسالة
متى يظهر
تحاول إزالة مفضلة لم تعد موجودة.
ماذا تفعل
حدّث قائمة المفضلة. قد يكون العنصر أُزيل بالفعل.
أخطاء رفع الملفات(8)
الملف كبير جداً
الرسالة
متى يظهر
الملف المرفوع يتجاوز حد 10 ميغابايت.
ماذا تفعل
اضغط الملف أو استخدم نسخة أصغر. للصور، قلّل الدقة. لملفات PDF، استخدم ضاغط PDF.
نوع ملف غير مدعوم
الرسالة
متى يظهر
رفعت ملفاً بصيغة غير مدعومة.
ماذا تفعل
حوّل الملف لأحد الصيغ المدعومة: PDF، JPEG، PNG، FHIR JSON، أو CCDA XML.
فشل قراءة الملف
الرسالة
متى يظهر
الملف تالف أو لا يمكن قراءته.
ماذا تفعل
حاول رفع الملف مجدداً. إذا استمر، جرّب نسخة أخرى من الملف.
فشل الرفع إلى التخزين
الرسالة
متى يظهر
خطأ في التخزين من جانب الخادم.
ماذا تفعل
انتظر وحاول مجدداً. إذا استمر، تواصل مع الدعم.
الملف محذوف بالفعل
الرسالة
متى يظهر
تحاول حذف ملف أُزيل بالفعل.
ماذا تفعل
لا حاجة لأي إجراء — الملف محذوف فعلاً. حدّث قائمة الملفات.
الملف محذوف نهائياً
الرسالة
متى يظهر
تحاول تنزيل ملف حُذف نهائياً.
ماذا تفعل
لا يمكن استعادة الملف. أعد رفعه إذا كان لديك نسخة.
الملف غير محذوف (لا يمكن الاستعادة)
الرسالة
متى يظهر
تحاول استعادة ملف ليس في سلة المحذوفات.
ماذا تفعل
الملف متاح بالفعل — لا حاجة للاستعادة.
فلتر حالة غير صالح
الرسالة
متى يظهر
معيار فلترة قائمة الملفات غير صالح.
ماذا تفعل
استخدم أحد القيم: uploaded, processed, failed, deleted.
أخطاء الأجهزة(1)
فشل حفظ/حذف رمز FCM
متى يظهر
فشل تسجيل الإشعارات الفورية.
ماذا تفعل
أعد تشغيل التطبيق. إذا لم تصلك إشعارات، اذهب إلى الإعدادات > الإشعارات وأعد تفعيلها.
أخطاء الدفع والاشتراك(1)
الاشتراك لا يتحدّث
متى يظهر
اشتريت أو ألغيت بريميوم لكن التطبيق لم يعكس ذلك.
ماذا تفعل
1. أغلق التطبيق وأعد فتحه. 2. اذهب إلى الإعدادات > الاشتراك واسحب للتحديث. 3. إذا لم يتحدث بعد 5 دقائق، تواصل مع الدعم مع إيصال الشراء.
أخطاء الخادم(4)
خطأ خادم داخلي
الرسالة
متى يظهر
حدث خطأ غير متوقع في الخادم.
ماذا تفعل
انتظر قليلاً وحاول مجدداً. إذا استمر، تواصل مع الدعم مع correlation_id من استجابة الخطأ (إن كان ظاهراً).
قاعدة البيانات غير متوفرة
متى يظهر
قاعدة البيانات متوقفة أو غير قابلة للوصول.
ماذا تفعل
انتظر 30 ثانية وحاول مجدداً. هذه عادةً مشكلة بنية تحتية مؤقتة.
خدمة المصادقة غير متوفرة
الرسالة
متى يظهر
خدمة مصادقة Firebase متوقفة مؤقتاً.
ماذا تفعل
انتظر بضع دقائق. تُحل عادةً خلال 5–10 دقائق.
فشل تهيئة الأمان
الرسالة
متى يظهر
فشلت تهيئة أمان قاعدة البيانات بعد تسجيل الدخول.
ماذا تفعل
حاول تسجيل الدخول مجدداً. إذا استمر، تواصل مع الدعم.
أخطاء انتهاء المهلة(2)
انتهاء مهلة الخدمة
متى يظهر
استغرق الطلب وقتاً طويلاً للمعالجة (خدمة، بحث، تحليل صور، تحليل نصوص، أو قاعدة بيانات).
ماذا تفعل
أعد المحاولة. إذا كنت على شبكة بطيئة، انتظر اتصالاً أفضل. لتحليل الصور، جرّب صورة أصغر.
انتهاء مهلة الطلب
الرسالة
متى يظهر
لم يستجب الخادم في الوقت المحدد.
ماذا تفعل
تحقق من اتصالك بالإنترنت وحاول مجدداً.
أخطاء الشبكة والاتصال(4)
لا يوجد اتصال بالإنترنت
متى يظهر
جهازك غير متصل بالإنترنت.
ماذا تفعل
تحقق من WiFi أو بيانات الهاتف. حاول فتح صفحة ويب في المتصفح لتأكيد الاتصال.
انتهت مهلة الاتصال
متى يظهر
الخادم غير قابل للوصول.
ماذا تفعل
1. تحقق من الإنترنت. 2. انتظر قليلاً وحاول مجدداً. 3. إذا كنت تستخدم VPN، جرّب تعطيله.
خطأ SSL/الشهادة
متى يظهر
تعذّر إنشاء اتصال آمن.
ماذا تفعل
تأكد من صحة التاريخ والوقت على جهازك. حدّث التطبيق لآخر إصدار.
خطأ في المقبس
متى يظهر
انقطع الاتصال بالشبكة.
ماذا تفعل
أعد المحاولة. انتقل لمنطقة ذات إشارة أفضل إذا كنت تستخدم بيانات الهاتف.
Authentication Errors(5)
Invalid or expired token
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
MESSAGE
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
MESSAGE
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
MESSAGE
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
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
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
MESSAGE
WHEN
You tried to use a Premium-only feature.
WHAT TO DO
Upgrade to Mara Premium from Settings > Subscription.
Access denied
MESSAGE
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
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
MESSAGE
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
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
MESSAGE
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
MESSAGE
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
MESSAGE
WHEN
Too many login attempts (limit: 10/minute).
WHAT TO DO
Wait 1 minute before trying to log in again.
Too many registration attempts
MESSAGE
WHEN
Too many sign-up attempts (limit: 5/minute).
WHAT TO DO
Wait 1 minute before trying to register again.
Too many verification attempts
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
MESSAGE
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
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
MESSAGE
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
MESSAGE
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
MESSAGE
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
MESSAGE
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
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
WHEN
The health insight or anomaly was removed or expired.
WHAT TO DO
Refresh your health dashboard to see current insights.
Meal not found
MESSAGE
WHEN
The meal entry was deleted or doesn't exist.
WHAT TO DO
Go back to your meal history and refresh.
File not found
MESSAGE
WHEN
The uploaded file was deleted or doesn't exist.
WHAT TO DO
Re-upload the file if needed.
Action expired
MESSAGE
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
MESSAGE
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
MESSAGE
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
MESSAGE
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
MESSAGE
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
MESSAGE
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
MESSAGE
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
MESSAGE
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
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
MESSAGE
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
MESSAGE
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
MESSAGE
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
MESSAGE
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
MESSAGE
WHEN
Food search query is empty or malformed.
WHAT TO DO
Enter a valid food name or description and try again.
Invalid image data
MESSAGE
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
MESSAGE
WHEN
You uploaded a non-image file for food analysis.
WHAT TO DO
Use a JPEG or PNG image.
Invalid text input
MESSAGE
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
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
MESSAGE
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
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
MESSAGE
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
MESSAGE
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
MESSAGE
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
MESSAGE
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
MESSAGE
WHEN
Server-side storage error.
WHAT TO DO
Wait and retry. If persistent, contact support.
File already deleted
MESSAGE
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
MESSAGE
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)
MESSAGE
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
MESSAGE
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
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
MESSAGE
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
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
MESSAGE
WHEN
Firebase authentication is temporarily down.
WHAT TO DO
Wait a few minutes. This usually resolves within 5–10 minutes.
Security initialization failed
MESSAGE
WHEN
Database security setup failed after login.
WHAT TO DO
Try logging in again. If persistent, contact support.
Timeout Errors(2)
Service timeout
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
MESSAGE
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.
لا توجد نتائج مطابقة.
جرّب كلمات مختلفة أو تصفّح الأقسام أدناه.
استكشاف الأخطاء العام
إذا واجهت خطأ غير مذكور هنا، جرّب هذه الخطوات بالترتيب:
- أعد المحاولة — كثير من الأخطاء مؤقتة. انتظر ثوانٍ وحاول مجدداً.
- أعد تشغيل التطبيق — أغلقه تماماً ثم افتحه من جديد.
- تحقق من الإنترنت — تأكد من اتصالك بشبكة مستقرة.
- حدّث التطبيق — ثبّت آخر إصدار من App Store أو Play Store.
- سجّل خروج ثم دخول — اذهب إلى الإعدادات > تسجيل الخروج، ثم سجّل دخولك مجدداً.
- امسح بيانات التطبيق — كحل أخير، احذف التطبيق وأعد تثبيته (بياناتك محفوظة على الخادم).
- تواصل مع الدعم — أرسل بريداً إلى support@mara.health مع بريدك الإلكتروني، رسالة الخطأ (لقطة شاشة إن أمكن)، correlation_id (إن ظهر)، وما كنت تفعله عند حدوث الخطأ.
- Retry — Many errors are temporary. Wait a few seconds and try again.
- Restart the app — Force close and reopen Mara.
- Check internet — Make sure you have a stable connection.
- Update the app — Install the latest version from the App Store / Play Store.
- Sign out and back in — Go to Settings > Sign Out, then log in again.
- Clear app data — As a last resort, uninstall and reinstall the app (your data is saved on the server).
- 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) | الخدمة متوقفة مؤقتاً |
| Type | Meaning |
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