انتقل إلى المحتوى
⁨NDDev Dev⁩، الصفحة الرئيسية
المجتمع
اللغة: العربية
العرض
المظهر
الحركة

تطوير واجهات API والأنظمة الخلفية

تطوّر NDDev الأنظمة الخلفية وواجهات API للمواقع الإلكترونية وتطبيقات الهاتف المحمول والأنظمة الداخلية: نماذج البيانات، ومنطق الأعمال، والتفويض، وWebhooks، والمهام الخلفية. نعتمد في تقنياتنا الأساسية على Python وFastAPI وSQLAlchemy وPostgreSQL، ونستخدم Redis للتخزين المؤقت والطوابير. تعمل الشركة منذ عام 2019.

لمن يناسب؟

للفرق التي لديها واجهة أمامية أو تطبيق للهاتف المحمول وتحتاج إلى خادم، وللشركات التي تتيح بياناتها للشركاء عبر API، وللمنتجات التي تجاوزت نظامها الخلفي القديم.

  • واجهات REST API مع تحديد الإصدارات
  • التفويض والصلاحيات
  • Webhooks والمهام الخلفية
  • الاختبارات والتوثيق

بنية النظام الخلفي الذي نسلّمه

نبدأ تصميم API من البيانات؛ فنضع أولاً النموذج في PostgreSQL وعقد نقاط النهاية، ثم نكتب الشيفرة البرمجية. نثبّت الإصدار في العنوان مثل /api/v1/، ونُرجع القوائم بتقسيم الصفحات القائم على المؤشر، ونُعيد الأخطاء بتنسيق واحد. ونضيف GraphQL وWebSocket عندما يحتاج العميل إلى استعلامات مرنة أو أحداث في الوقت الفعلي.

  • نموذج البيانات وترحيلات PostgreSQL
  • واجهات REST API مع تحديد الإصدارات وتقسيم الصفحات وتنسيق موحد للأخطاء
  • المصادقة عبر JWT أو OAuth 2.0 أو تسجيل الدخول عبر رابط في البريد الإلكتروني
  • صلاحيات RBAC أو ABAC على جانب الخادم
  • المهام الخلفية والطوابير والمجدول
  • Webhooks مع التحقق من التوقيع
  • اختبارات الوحدات (unit) والاختبارات التكاملية
  • صورة Docker وملف README للنشر

تنتقل العمليات الطويلة إلى الخلفية: الرسائل البريدية، والتبادل مع 1C، ومعالجة الملفات. ونحفظ المهام والأحداث الصادرة في PostgreSQL إلى جانب البيانات، لذلك يظهر الحدث في اللحظة نفسها التي يُحفظ فيها السجل. وبهذه البنية يعمل النظام الخلفي لنظام المكتبات المركزي في ألماتي: خدمات FastAPI، وعمليات معالجة للمزامنة والكتب والبريد والإشعارات، ومجدول واحد للمهام المجدولة.

نحمي الاستدعاءات الخارجية؛ إذ نتحقق من توقيع Webhook، ونعالج التكرارات بأسلوب متساوي الأثر يمنع تكرار التنفيذ، وعند حدوث خلل لدى الشريك نعيد إرسال الطلب بفاصل زمني متزايد ونوقف الاستدعاءات مؤقتاً عبر آلية circuit breaker. كما يُدوَّن كل استدعاء في السجل، وتُحفظ البيانات السرية في متغيرات البيئة.

ثلاث مراحل للعمل على API

  1. العقد

    نوصّف الكيانات ونقاط النهاية والأدوار والأخطاء. ويبدأ فريق الواجهة الأمامية وفريق تطبيقات الهاتف المحمول العمل وفق العقد فوراً، بالتوازي مع الخادم.

  2. التنفيذ والاختبارات

    نكتب الخدمة والترحيلات والاختبارات، وننشرها على خادم تجريبي ونتيح الوصول لمطوريك.

  3. الإطلاق والتسليم

    ننشر API على خادم التشغيل مع فحوصات السلامة والسجلات، ونسلّم المستودع البرمجي والتوثيق وصلاحيات الوصول.

الأسئلة الشائعة حول الأنظمة الخلفية

كم تبلغ تكلفة تطوير API؟

يظهر السعر «ابتداءً من» لواجهة API في قسم التكلفة. وتتأثر القيمة النهائية بعدد الكيانات ونقاط النهاية، والتكاملات، ومتطلبات التحمّل والأمان. ونثبّت السعر النهائي والمدة في المواصفات الفنية عندما يتضح عقد API.

لماذا Python وFastAPI؟

يوفر إطار FastAPI نماذج محددة الأنواع عبر Pydantic، وعملاً غير متزامن مع قاعدة البيانات عبر SQLAlchemy 2، وتوصيفاً لنقاط النهاية مباشرة من الشيفرة البرمجية. أما الخدمات ذات المتطلبات الخاصة للسرعة فنكتبها بلغة Go أو Node.js.

هل يمكنكم تطوير نظامنا الخلفي الحالي وتعديله؟

نعم. نبدأ بقراءة الشيفرة البرمجية ومخطط قاعدة البيانات، ونشغّل الاختبارات، ثم نوضّح ما يعمل وما ينطوي على مخاطر. ونضيف نقاط النهاية الجديدة إلى جانب القديمة وننقل العملاء إليها تدريجياً.

كيف تختبرون API؟

تتحقق اختبارات الوحدات (unit) من منطق الأعمال، بينما تعمل الاختبارات التكاملية على قاعدة بيانات PostgreSQL فعلية. وللمستهلكين الخارجيين نثبّت شكل الاستجابات باختبارات العقود، كما في مشروع Abonmarket، فيظهر أي تغيير قبل الإطلاق.

هل يتحمّل API الأحمال؟

نجري اختبارات التحمّل قبل الإطلاق، ونخزّن الطلبات المتكررة مؤقتاً في Redis، وننقل العمليات الثقيلة إلى الخلفية. وتعمل الخدمة داخل حاويات خلف Nginx، ويمكن توسيع نطاقها مع النمو.

ما الذي سنحصل عليه عند التسليم؟

المستودع البرمجي، وتوثيق API، وملف README للنشر، وصلاحيات الوصول إلى الخادم وقاعدة البيانات، ونسخة احتياطية وقت التسليم. وننقل حقوق الشيفرة البرمجية وفق الاتفاق.

ابتداءً من ‏3,400 US$

ضمان مجاني
30 يوم

الأسعار المذكورة هي أسعار ابتدائية للمعلومات فقط، ولا تُعدّ عرضاً عاماً. يُحدَّد السعر النهائي في المواصفات الفنية.

Web development

صِف الجهات التي يجب أن يقدّم لها API الخاص بك البيانات وما هي هذه البيانات

أرسل مخطط البيانات أو نماذج الشاشات أو وصف التكامل. سنقترح عقد API ونحدّد السعر.

سنردّ خلال 24 ساعة

المساعد

جارٍ تحميل المساعد…