واجهات برمجة تُصمَّم كمنتجات لها مستخدمون حقيقيون
تغطي هذه الخدمة الواجهة التي يطل بها منتجك على العالم: نقاط نهاية REST وGraphQL، وخطافات الويب (Webhooks)، والقنوات الفورية، وما يحيط بها من مصادقة وتحديد لمعدل الطلبات وتوثيق. وهي الخيار المناسب حين تعتمد جهات عدة على نظام خلفي واحد، مثل تطبيق ويب وتطبيق جوال وأنظمة الشركاء، ويحتاج كل منها إلى عقد ثابت يمكن توقع سلوكه.
ننطلق من مستخدمي الواجهة لا من قاعدة البيانات. فنحدد الموارد وصيغ الأخطاء وتقسيم النتائج إلى صفحات وقواعد الإصدارات في مخطط OpenAPI أو GraphQL أولاً، ثم نبني عليه، مع اختبارات للعقد توقف البناء إذا انحرف السلوك عنه. والنتيجة واجهة تستطيع الفرق الأخرى أن تتكامل معها من التوثيق وحده، دون أن تقرأ شيفرتك المصدرية.
تصميم واجهات REST
نحدد في مواصفة OpenAPI نمذجة الموارد والتسمية المتسقة وتقسيم النتائج والتصفية وصيغ الأخطاء، فتتصرف كل نقطة نهاية كما تصرفت سابقتها.
مخططات GraphQL
مخططات محددة الأنواع، ودوال لجلب البيانات، وحدود لتكلفة الاستعلامات، لمنتجات تحتاج شاشاتها إلى البيانات نفسها بأشكال مختلفة، مع تجميع الطلبات لتفادي تكرار استدعاء قاعدة البيانات.
المصادقة وصلاحيات الوصول
نعتمد OAuth 2.0 وOpenID Connect وجلسات JWT ومفاتيح API محددة النطاق، ونفحص الصلاحيات على الخادم في كل طلب بدلاً من الوثوق بما يقوله الطرف المتصل.
خطافات الويب والأحداث
خطافات ويب موقّعة مع إعادة المحاولة، ومفاتيح تمنع تنفيذ العملية مرتين، وسجلات للتسليم، إضافة إلى قنوات WebSocket أو Server-Sent Events حيث يحتاج مستخدمو الواجهة إلى التحديثات لحظة حدوثها.
التكامل مع الأطراف الخارجية
نربط مزودي الدفع وأنظمة إدارة علاقات العملاء (CRM) وخدمات الهوية والأنظمة الداخلية عبر طبقات وسيطة لها مهل زمنية وإعادة محاولة، حتى لا يتحول عطل خارجي إلى عطل عندك.
الإصدارات وإيقاف الدعم
سياسة للإصدارات، وسجل للتغييرات، وترويسات تعلن الإيقاف المرتقب، تتيح لك تغيير الواجهة دون أن تعطل تطبيقات مثبتة لدى المستخدمين أو شركاء في منتصف التكامل.
ما تتسلمه منا
- الشيفرة المصدرية للواجهة العاملة في بيئة التشغيل
- ملفات مخطط OpenAPI أو GraphQL
- توثيق مرجعي مستضاف
- مجموعة Postman مع أمثلة للطلبات
- اختبارات مؤتمتة للعقد والتكامل
- سياسة للإصدارات وإيقاف الدعم
- لوحات مراقبة وقواعد تنبيه
- الوصول إلى جميع المستودعات والبيئات
طريقة عملنا
- 01
حصر مستخدمي الواجهة
ندوّن كل تطبيق وشريك ونظام داخلي سيستدعي الواجهة، والبيانات التي يحتاجها كل منهم، والقيود التي يعمل ضمنها، ثم نحدد النطاق والأولويات من هذه القائمة.
- 02
تصميم العقد
نكتب نقاط النهاية والمخططات ورموز الأخطاء ومسارات المصادقة في مواصفة نراجعها مع فريقك. ويستطيع مطورو الواجهة الأمامية والجوال أن يبنوا على خادم محاكاة بينما يبدأ التنفيذ.
- 03
البناء والاختبار
ننفذ على دفعات صغيرة تخضع للمراجعة. وتعمل اختبارات العقد والتكامل والحمل في مسار البناء والنشر، وتصدر كل نقطة نهاية ومعها توثيقها وأمثلة طلباتها جاهزة.
- 04
الإطلاق والمراقبة
تُطلق الواجهة خلف بوابة API مع حدود لمعدل الطلبات وسجلات منظمة وتتبع وتنبيهات. ثم نراقب معك الاستخدام الفعلي، ونحسّن الاستعلامات البطيئة، ونسلّم أدلة التشغيل للحوادث الشائعة.
التقنيات التي نستخدمها
| المجال | التقنيات |
|---|---|
| لغات البرمجة | TypeScript، Node.js، Python، Go |
| أطر العمل | NestJS، Fastify، FastAPI، Apollo Server |
| البيانات | PostgreSQL، Redis، MongoDB، Elasticsearch |
| الأدوات | OpenAPI، Postman، Jest، Kong، Docker |
تطبيقات وشركاء يعتمدون جميعاً على واجهة واحدة
يحتاج تطبيق الويب وتطبيقات الجوال والشركاء الخارجيون إلى البيانات نفسها، وكل منهم يُخدم اليوم بنقاط نهاية أُضيفت على عجل. ما تحتاج إليه واجهة واحدة موثّقة، بقواعد واضحة للوصول والتغيير والتعامل مع الأعطال، قبل أن يبدأ التكامل التالي.
- أنظمة خلفية لتطبيقات الجوال
- واجهات برمجة عامة للمطورين
- تكاملات الشركاء والأسواق الإلكترونية
- استبدال واجهة قديمة غير موثّقة
- الربط مع أنظمة الدفع وإدارة علاقات العملاء
- تقسيم نظام أحادي بحسب مجالات العمل
أسئلة شائعة
REST أم GraphQL: أيهما نختار لواجهتنا؟
يتوقف ذلك على من سيستخدمها. فـREST يناسب الواجهات العامة وواجهات الشركاء، لأنه سهل في التخزين المؤقت والتوثيق والتأمين، وتتعامل معه معظم الأدوات تقريباً. أما GraphQL فيناسب المنتجات التي تحتاج شاشاتها الكثيرة إلى تركيبات مختلفة من البيانات نفسها، ويريد فريق الواجهة الأمامية فيها أن يتقدم دون انتظار نقاط نهاية جديدة. وكثيراً ما نوصي بـREST للجهات الخارجية وGraphQL لتطبيقاتك أنت.
ما الفرق بين تطوير واجهات البرمجة وهندسة الأنظمة الخلفية؟
يركز تطوير واجهات البرمجة على الواجهة نفسها: العقد، والتوثيق، والمصادقة، وتجربة المطور لكل من يستدعي نظامك. أما هندسة الأنظمة الخلفية فتركز على ما يقع خلفها، مثل نماذج البيانات والطوابير والمعالجة في الخلفية والتوسع تحت الضغط. وتحتاج مشاريع كثيرة إلى الاثنين. فإن كانت مشكلتك الرئيسية بطء التكاملات أو هشاشتها، فابدأ من هنا. وإن كانت في قدرة المعالجة أو اتساق البيانات، فابدأ بالأنظمة الخلفية.
هل يمكنكم توسيع واجهة قائمة لدينا أو استبدالها؟
نعم. نبدأ بتدقيق نقاط النهاية الحالية ومستخدميها وحجم الطلبات على كل منها. ثم إما أن نضيف إلى الواجهة الحالية ملتزمين بأعرافها، وإما أن نطلق إصداراً جديداً إلى جانبها وننقل مستخدميها واحداً بعد آخر. وتبقى نقاط النهاية القديمة في مكانها إلى أن يتوقف استدعاؤها تماماً، فتواصل التطبيقات المثبتة على الهواتف عملها طوال الفترة.
كيف تحمون الواجهة من إساءة الاستخدام وتسرب البيانات؟
نتحقق من هوية كل طلب، ثم من صلاحيته على المورد المحدد الذي يطلبه، وبذلك نغلق أكثر فئات ثغرات الواجهات شيوعاً. ونفحص المدخلات وفق المخطط، ونطبق حدود معدل الطلبات لكل مفتاح، ونحفظ الأسرار في خزنة مُدارة لا في الشيفرة. كما نضيف سجلات تدقيق للإجراءات الحساسة، ونشغّل فحوصاً أمنية مؤتمتة في مسار النشر قبل كل إصدار.
ما الذي نتسلمه عند انتهاء المشروع، ومن يملكه؟
تُحدَّد شروط الملكية والترخيص في اتفاقية المشروع. وتتسلم الشيفرة المصدرية كاملة، ومخطط OpenAPI أو GraphQL، ومجموعة الاختبارات، وإعدادات البنية التحتية، والتوثيق المكتوب، إلى جانب الوصول إلى جميع المستودعات والبيئات. وتعمل الشيفرة في حساباتك منذ البداية، فلا حاجة إلى خطوة نقل في النهاية. كما نسلّمك أدلة التشغيل ليتمكن مهندسوك من نشر الواجهة ومراقبتها وتوسيعها دوننا.