Family Tree API

واجهة برمجة تطبيق شجرة عائلة الخضري — للمبرمجين (Flutter).

التوثيق التفاعلي ←كل الروابط مع الحقول والردود، وتجربة الطلبات مباشرة دليل المطوّر ←شرح الـ API خطوة بخطوة مع أمثلة Flutter Postman Collection121 طلب في 12 مجلد Postman Environmentالسيرفر الحقيقي (base_url جاهز) OpenAPI 3لتوليد الكود (openapi-generator / dio)

البداية

Base URL:  https://api-production-34bd.up.railway.app/api/v1
Headers:   Accept: application/json
           Accept-Language: ar | en
           Authorization: Bearer <token>   (بعد تسجيل الدخول)

التصفح كامل بدون حساب: الشجرة، الأفراد، الملفات، الأخبار.
تسجيل الدخول: POST /auth/login بـ email وpassword → data.token، والتسجيل POST /auth/register.
الأخطاء دائماً بالشكل { "message", "code", "errors"? } — اعتمدوا على code لأنه لا يتغير مع اللغة.
الحقول المترجمة تُرسل {"ar": "...", "en": "..."} أو نص عادي مع Content-Language.
الموظف بدون صلاحية مباشرة يرجع له 202 مع طلب تعديل ينتظر موافقة المدير.
الشجرة للرسم: GET /graph (nodes + families)، مع If-None-Match لتوفير التحميل (304).

Postman

Import → اسحبوا ملف الـ Collection وملف الـ Environment.
اختاروا البيئة Family Tree — Live (Railway) من أعلى اليمين، وعبّوا email وpassword بحسابكم.
شغّلوا Login — التوكن يُحفظ تلقائياً في {{token}}.

⚠️ هذا السيرفر الحقيقي وفيه بيانات العائلة: لا تشغّلوا مجلد 0. Quick start ولا طلبات الإضافة والحذف عليه — للتجربة اطلبوا حساباً تجريبياً أو نسخة محلية.