https://thedotnetblog.com/ar/tags/rest-api/Articles, tutorials and insights from the .NET community.Hugoar@thedotnetblog (The .NET Blog)@thedotnetblogFri, 17 Jul 2026 00:00:00 +0000https://thedotnetblog.com/ar/news/emiliano-montesdeoca/data-api-builder-custom-paths-domain-first/Fri, 17 Jul 2026 00:00:00 +0000Emiliano Montesdeocahttps://thedotnetblog.com/ar/news/emiliano-montesdeoca/data-api-builder-custom-paths-domain-first/مسارات REST المركبة في DAB هي ميزة صغيرة ذات تأثير معماري كبير لتصميم APIs الموجه للمجال.<p>المصدر الأصلي: <a href="https://devblogs.microsoft.com/azure-sql/data-api-builder-custom-rest-paths/">Compose your API surface with Data API builder custom paths</a></p> <p>دعم المسار المركب الجديد في Data API Builder قد يبدو كتحسين بسيط في التكوين، لكنه في الواقع يحل توترًا طويل الأمد في تصميم API: تسرب طوبولوجيا قاعدة البيانات إلى تصميم نقطة النهاية العامة.</p> <p>المسارات الافتراضية القائمة على الكيانات رائعة للبدايات السريعة. غالبًا ما تكون خاطئة لـ APIs المنتج طويلة الأمد. الأنظمة الحقيقية تحتاج هياكل مسار تطابق مفاهيم الأعمال وحدود الملكية ونماذج المستهلك الذهنية.</p> <p>لهذا السبب تغيير DAB هذا مهم. يمكنك الاحتفاظ براحة API المولدة مع تقديم سطح موجه للمجال أولاً وأنظف.</p> <p>رأيي الشخصي بسيط: إذا كانت بنية مسار API الخاص بك تعكس أسماء الجداول الخام في الإنتاج، فأنت عادة ما تحسن لراحة الخلفية على حساب وضوح العميل.</p> <p>بالمسارات المخصصة، يمكن للفرق نمذجة حدود أفضل، مثل المبيعات والفواتير والدعم أو أسطح خاصة بالشركاء. هذا لا يحل محل حوكمة API المناسبة، لكنه يعطي مستخدمي DAB طريقة عملية لمواءمة تصميم المسار مع لغة المنتج.</p> <p>إرشادات عملية للفرق التي تتبنى هذه الميزة:</p> <ul> <li>حدد سياسة تسمية قبل إضافة المسارات بشكل عشوائي. الأقسام الفرعية غير المتسقة تصبح فوضى طويلة الأمد.</li> <li>حدد نقاط النهاية لسياقات محدودة، وليس لمخططات تنظيمية. الفرق تتغير؛ دلالات المجال يجب أن تكون مستقرة.</li> <li>تعامل مع بنية المسار كجزء من استراتيجية الإصدار الخاص بك ووثق التغييرات الجوهرية صراحة.</li> <li>تحقق من سلوك التفويض على طول هياكل المسار المخصصة بحيث يقترن وضوح المسار بوضوح الأمان.</li> </ul> <p>ما أقدره في DAB بشكل عام هو نموذج الرفع: تحصل على التقسيم والتصفية والإسقاط وآليات نقطة نهاية أخرى دون كتابة كود تحكم متكرر. المسارات المخصصة تجعل ذلك الرفع أكثر جاهزية للإنتاج بتقليل أحد أكبر الاعتراضات من مهندسي API.</p> <p>هناك تحذير واحد. تكوين المسار الأفضل يمكن أن يغري الفرق بكشف الكثير بسرعة لأن التوليد يبدو سهلاً. الحواجز لا تزال مهمة: حافظ على كشف الكيان متعمدًا، طبق السياسة مركزيًا، وتجنب بناء عقود عامة عرضية من تجارب المخطط الداخلية.</p> <p>لمؤسسات .NET تحت ضغط التوصيل، هذه الميزة هي فتح إنتاجية إذا استُخدمت بانضباط. يمكنك التحرك أسرع من طبقات API المصنوعة يدويًا مع الحفاظ على سطح نقطة نهاية متماسك وصديق للأعمال.</p> <p>الخلاصة: مسارات DAB المخصصة ليست حول تجميل عناوين URL. إنها حول استعادة نية تصميم API مع الحفاظ على الكفاءة التشغيلية لنقاط النهاية المولدة.</p>