Written with AI assistance from the source video. The video is the authority.
30:37Vercel
Log in to leave a comment
No posts yet
تتميز Notion بواجهة سهلة الاستخدام، وهذا هو سبب لجوء المطورين المستقلين لاستخدامها كخلفية (Backend) عندما لا يملكون الوقت الكافي لبناء خادم وقاعدة بيانات بشكل منفصل. ولكن، إذا حافظت على هذه البنية في بيئة الإنتاج (Production)، فستصطدم بالمشكلات سريعاً. تفرض Notion API حد 3 طلبات في الثانية لكل رمز تكامل (Integration Token). وإذا تجاوزت هذا الحد، فستحصل على أخطاء 429 أو 529.
تتفاقم المشكلة بمجرد تجمع القليل من البيانات. الحد الأقصى للبيانات التي يمكن جلبها دفعة واحدة هو 100 عنصر. يجب عليك تنفيذ الترحيل (Paging) بنفسك، وتصبح منطق الخادم معقداً بسبب تحليل بنى الخصائص المتداخلة. يبلغ الحد الأقصى لحجم بيانات الخصائص في الصفحة الواحدة 2.5 ميجابايت. إذا قمت بنشر الخدمة متجاهلاً هذه الحدود، فستتوقف الشاشة عن الاستجابة أو ستفقد البيانات عند تدفق طلبات المستخدمين.
لا يمكنك الانتظار طويلاً لاستدعاءات API الخارجية في كل مرة. يجب وضع طبقة تخزين مؤقت (Caching Layer) في المقدمة. من خلال تخزين البيانات الثابتة مؤقتًا في Redis أو Cloudflare KV، والتحديث الدوري باستخدام عامل خلفي (Background Worker)، يمكنك معالجة 80 بالمائة من إجمالي استدعاءات API محلياً. تنخفض سرعة الاستجابة إلى أقل من 200 مللي ثانية.
تحتاج أيضًا إلى محلل (Parser) في خلفية Python لتسوية خصائص Notion المعقدة. استجابات Notion متداخلة بشكل عمقي حسب النوع. قم بإنشاء محلل يقوم بالتكرار عبر القواميس للتحقق من حقول الأنواع، ودمج النصوص في سلاسل نصية (Strings)، واستخراج مصفوفات المعرفات وحدها للبيانات العلائقية. من خلال عملية المعالجة المسبقة هذه فقط، يمكن لمطوري الواجهة الأمامية استخدام البيانات مباشرة دون منطق تحليل.
حتى إذا تغير الصف في Notion، فإن إرسال طلب API فور تلقي Webhook سيعيد البيانات القديمة، ويرجع ذلك إلى تأخر الفهرسة. هذا هو سبب فقدان الحزم أو تشابك البيانات.
لمعالجة هذه المشكلة، تحتاج إلى روتين استعادة دوري في الخلفية. استخدم عامل تصفية وقت التعديل في Notion API لمقارنة التخزين المؤقت المحلي بالوقت الفعلي (Timestamp). إذا حدث خطأ، فانتظر باستخدام خوارزمية التراجع الأسي (Exponential Backoff) ثم أعد المحاولة. يجب تضمين روتين يقوم بالتحديث الإجباري للسجلات التي تغيرت فقط بعد نقطة المزامنة الأخيرة لضمان عدم تلف سلامة البيانات.
من الخطير جداً كتابة رمز يرسل الطلبات مباشرة من متصفح العميل حاملاً مفتاح Notion السري. سيتم كشف الرمز كما هو وستظهر مشاكل CORS. هذا هو السبب في ضرورة وضع وكيل وسيط بدون سرتفر (Serverless Middleware Proxy) في المنتصف.
يرسل العميل الطلبات إلى الوسيط بدون سرتفر، والذي يقوم بدوره بإرفاق الرمز المخفي في متغيرات بيئة الخادم للتواصل مع Notion API. إذا كنت في بيئة متعددة المستأجرين (Multi-tenant)، يجب وضع جدول صلاحيات عكسي في الوسيط يقوم بربط معرف مستخدم التطبيق بمالك صفحة Notion. من خلال بناء هذا الهيكل، يمكنك منع حوادث تسرب الرموز وعزل البيانات بأمان.