ممارسة واجهات البرمجة

إدارة واجهات البرمجة (API) في المملكة

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

السياسة قبل البوابة نشر داخل المملكة حين يلزم

باختصار

طبقة واحدة تعرف كل واجهة، وتفرض القواعد نفسها عليها جميعًا

تصمّم إنتركي طبقة واجهات البرمجة وتنفّذها وتشغّلها للمؤسسات في المملكة: جرد ما هو موجود، والسياسات التي تنطبق عليه، المصادقة والتفويض وحدود المعدل والإصدارات، والبوابة التي تفرضها، وتشغيل تلك البوابة بعد ذلك. والمنصة التي تنفّذها إنتركي للبوابة هي Kong؛ والممارسة واحدة أيًا كان المنتج تحتها.

والنطاق محدود عمدًا. ربط نظامين لم يُصمَّما للحديث معًا هو تكامل الأنظمة، وبناء الخدمة خلف الواجهة هو تطوير البرمجيات. هذه الصفحة عن الطبقة أمام خدمات قائمة أصلًا: جعلها قابلة للاكتشاف ومحكومة وآمنة للعرض على شريك أو تطبيق جوال أو إدارة أخرى.

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

الأعراض

كيف يبدو هذا قبل إصلاحه

الحالات التي تصفها المؤسسات، وما تدل عليه كل منها عادةً. قليل جدًا منها يصفه من يعيشه مشكلةَ واجهات برمجة.

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

الترتيب

البوابة هي الخطوة الثالثة

البرامج التي تبدأ بتثبيت بوابة تنتهي ببوابة أمام جرد لم يتفق عليه أحد وسياسة لم يكتبها أحد. كل خطوة أدناه لا تكون آمنة إلا حين تصمد التي قبلها.

  1. اجردوا ما هو موجود

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

  2. اكتبوا السياسة

    من يجوز له استدعاء ماذا، وبأي اعتماد، وبأي معدل، وكيف تُقدَّم الإصدارات وتُوقف. قصيرة، ومكتوبة، ومتفق عليها مع الفرق التي تملك الخدمات لا مفروضة عليها.

  3. انشروا البوابة

    الآن، لا قبل ذلك. موضوعة حيث يقول جواب موضع الحفظ إن الحركة يجوز أن تمرّ، بحجم الحركة التي وجدها الجرد، والسياسة معبَّر عنها إعدادًا لا محفوظة في ذاكرة شخص.

  4. أضيفوا المستهلكين

    التوثيق وبيانات الاعتماد والحدود تُصدر عبر إجراء واحد، وتُغلق الأبواب الخلفية الموازية مع انتقال كل مستهلك. ومقياس هذه الخطوة كم استثناءً مبنيًا يدويًا بقي.

  5. شغّلوا وراقبوا

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

القيد

أين تعمل البوابة يقرّره ما يمرّ عبرها من بيانات

مستوى التحكم ومستوى البيانات سؤالان مختلفان عن موضع الحفظ

ترى بوابة واجهات البرمجة كل طلب وكل رد. وهذا يجعل موقعها قرار تصنيف بيانات قبل أن يكون قرار معمارية: إن كان لا يجوز للحمولات أن تغادر المملكة، فلا يجوز ذلك للمكوّن الذي يفحصها.

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

النطاق

كيف يتشكّل العمل عادةً

أربعة أشكال. الأول كثيرًا ما يُشترى وحده، وهو يقرّر هل يستحق الباقي الشراء.

الجرد والسياسة

ما هو موجود، ومن يملكه، ومن يستدعيه، والقواعد المكتوبة التي ستحكمه. قصير، ومخرجه جرد بقرار لكل صف.

تنفيذ البوابة

المنصة منشورة في شكل موضع الحفظ الذي يسمح به التصنيف، والسياسة إعدادًا، وأول المستهلكين منقولون عبرها.

إضافة المستهلكين

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

التشغيل

البوابة تُشغَّل منصة إنتاج: الترقيات، والسعة، ورصد كل مستهلك، وتقويم الإيقاف، على أسبوع العمل السعودي من الرياض، خدمةً مُدارة حين تُطلب.

الطبقة السعودية

ما الخاص بهذا السوق

أمران يغيّران شكل هذا العمل هنا لا مجرد ترجمته.

الواجهات المنشورة صارت متطلبًا قطاعيًا أكثر فأكثر، لا تفضيلًا هندسيًا. تتوقع عدة برامج قطاعية سعودية من المؤسسات أن تعرض واجهات محدّدة للجهات المنظِّمة أو الشركاء أو منصات التكامل، والخدمات المصرفية المفتوحة أشهر مثال. والمؤسسة التي تلبّي متطلبًا كهذا بنقطة نهاية مبنية يدويًا لكل التزام تنتهي إلى الأعراض في الجدول أعلاه، على موعد نهائي. والطبقة المحكومة هي ما يجعل الالتزام التالي تغيير إعداد.

المحتوى العربي يمرّ عبر الطبقة نفسها. تحمل الحمولات أسماء وعناوين ونصوصًا حرة بالعربية، وسياسة بوابة تفحصها أو تسجّلها أو تحوّلها يجب أن تتعامل مع النص من اليمين إلى اليسار والخانات مختلطة الحروف والترميز على نحو صحيح. يُختبر هذا على حمولات محلية حقيقية أثناء التنفيذ لا يُكتشف حين يُرفض أول طلب عربي من شريك.

يُسلَّم العمل من الرياض عبر ممارسة الهندسة التي تؤدّي أيضًا تكامل الأنظمة وتبني الخدمات خلف الواجهات، وهذا يهم هنا أكثر من المعتاد: طبقة واجهات صمّمها من لا يستهلكها أبدًا تميل إلى أن تكون صحيحة تقنيًا ومتجاهَلة عمليًا.

تعريف الاكتمال

كيف يبدو المكتمل فعلًا

كل بند صحيح أو غير صحيح، ويستطيع التحقق منه من لم يشارك:

  • يوجد جرد واحد للواجهات، لكل مدخل فيه مالك، ولا تدخل واجهة جديدة الخدمة دون الانضمام إليه
  • تُفرض المصادقة والتفويض وحدود المعدل في البوابة، ولا يصل أي مستهلك إلى خدمة محكومة بأي طريق آخر
  • لكل واجهة إصدار، وسياسة إيقاف بُلّغ بها مستهلكوها، وتاريخ يختفي بعده الإصدار القديم
  • يُضاف المستهلك الجديد عبر إجراء موثّق واحد، وعدد الاستثناءات المبنية يدويًا معروف ويتناقص
  • الحركة والأخطاء وزمن الاستجابة مرئية لكل مستهلك لمن سيُستدعى
  • موقع البوابة نفسها يطابق تصنيف بيانات ما يمرّ عبرها، والقرار مكتوب
  • للمنصة إيقاع ترقية ومشغّل مُسمّى، سواء كان فريقكم أم فريق إنتركي

أسئلة

أسئلة يطرحها المشترون فعلًا

سؤال شائع

هل نحتاج إلى منصة إدارة واجهات برمجة، أم بوابة فقط؟

الفرق في أغلبه مفردات مورّدين. ما تحتاجونه طبقة تفرض السياسة على الحركة وإجراء يحكم ما خلفها. إن كان عند المؤسسة حفنة من الواجهات الداخلية وفريق واحد، فبوابة مع قواعد مكتوبة تكفي. وإن كان الشركاء أو تطبيقات الجوال أو الجهات المنظِّمة يستهلكون واجهاتكم، فأجزاء الإضافة والتوثيق والإصدارات هي العمل، ومنصة تؤدّيها تستحق كلفتها.

سؤال شائع

أي منصة تنفّذون؟

Kong، للبوابة وطبقة سياساتها. والممارسة في هذه الصفحة، الجرد والسياسة والتسلسل والتشغيل، لا تعتمد عليها، والمؤسسة الملتزمة أصلًا بمنتج آخر لا تُصرف؛ فعمل الجرد والسياسة واحد، والبوابة تُعدّ لا تُستبدل.

سؤال شائع

هل يمكن أن تعمل المنصة كلها داخل المملكة؟

نعم. يمكن أن يعمل مستوى الحركة على بنية تشغّلونها داخل المملكة، ومستوى الإعداد كذلك، مقابل تشغيله. وملاحظة موضع الحفظ أعلاه تشرح لماذا هذان قراران منفصلان وما يكلّفه كل منهما. وما لن تفعله إنتركي هو افتراض الجواب: يأتي من تصنيف بياناتكم لا من تفضيل نشر.

سؤال شائع

كم يستغرق هذا؟

الجرد مسألة أسابيع ويؤتي ثمره فورًا، لأن معرفة ما عندكم تستحق أيًا كان ما تفعلونه بعدها. وأول بوابة مع أول المستهلكين منقولين مشروع محدود. أما نقل كل مستهلك وإيقاف كل باب خلفي فيُقاس بأرباع السنة ويعتمد على جداول إصدار مستهلكيكم أكثر بكثير مما يعتمد على أي شيء تتحكّم فيه إنتركي.

سؤال شائع

ماذا عن الواجهات التي نعرضها على الإنترنت العام؟

تمرّ عبر الطبقة نفسها بسياسة أشد: أنواع اعتماد أقوى، وحدود أضيق، ومراجعة أمنية لإعداد البوابة نفسه. أما ما لا تستطيعه البوابة فجعل خدمة غير آمنة آمنة؛ تستطيع فرض من يصل إليها وكم مرة. والخدمة خلفها ما زال يجب أن تُبنى وتُراجع كما ينبغي، وهذه مهمة ممارسة البرمجيات لا هذه.

الخطوة التالية

ابدؤوا مما تعرضونه فعلًا

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

أو مباشرةً

+966-11-2180999 info@interkey.com.sa

أبراج التعاونية، البرج الشمالي، الطابق السابع، طريق الملك فهد، العليا، ص.ب. ٥٦٨٣٥، الرياض ١١٥٦٤، المملكة العربية السعودية

أو صفحة تنفيذ Kong

يرد فريق الرياض في أيام العمل السعودية، بالعربية أو الإنجليزية.

نشر بواسطة إنتركي. آخر تحديث . إنتركي مسجلة في الرياض بالسجل التجاري رقم 1010156897.