تخطَّ إلى المحتوى الرئيسي
حوكمة واجهات برمجة التطبيقات

حوكمة البيانات تتوقف عند قاعدة البيانات. وبياناتكم تغادر عبر واجهات برمجة التطبيقات.

منصات دليل البيانات تحكم الجداول، وبوابات API تدير حركة المرور، وغوافا تُدخل واجهات API إلى دليل البيانات: فهي تفهرس نقاط النهاية من مواصفات OpenAPI لديكم، وتتيح لكم ربط كل واحدة منها بالجداول والأعمدة التي تقف خلفها، ووسم نقاط النهاية بالتصنيفات نفسها التي تستخدمونها لبياناتكم، وتُبرز النقاط الموسومة بأنها عامة أو شخصية أو مالية — لتصبح الواجهات التي تقدّم أكثر بياناتكم حساسية محكومة لا غير مرئية.

النقطة العمياء

منصات دليل البيانات تحكم الجداول، وبوابات API تدير حركة المرور — ولا أحد يربط بينهما.

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

  • دليل البيانات لديكم يعرف أن الجدول مصنّف — لكنه لا يعرف أن واجهة API تعرضه للعالم الخارجي.
  • بوابة API لديكم ترى كل طلب — لكنها لا تدرك حساسية البيانات الكامنة خلف نقطة النهاية.
  • إطار المكتب الوطني لإدارة البيانات (NDMO) يتوقع حوكمة مشاركة البيانات أينما حدثت، بما في ذلك مجالا مشاركة البيانات والتشغيل البيني — وواجهات API هي بالضبط حيث تحدث المشاركة.
  • نظام حماية البيانات الشخصية (PDPL)، المطبّق بالكامل منذ سبتمبر 2024 وتتولى سدايا إنفاذه فعليًا، يجعل الانكشاف غير المحوكم للبيانات الشخصية خطرًا تنظيميًا لا مجرد سهو هندسي.

موصلات في مرحلة المعاينة لبوابات API التي تشغّلونها اليوم

  • Kong
  • Amazon API Gateway
  • Azure API Management
  • Google Cloud API Gateway
  • NGINX

مسار البيانات حتى واجهات API

اربطوا كل نقطة نهاية بالجداول التي تقف خلفها، وصولًا إلى مستوى العمود

تمدّ غوافا مسار البيانات على مستوى العمود إلى ما بعد مستودع البيانات وصولًا إلى طبقة واجهات API. تُفهرس نقاط النهاية من مواصفات OpenAPI لديكم، وتربطون كل واحدة منها بأصول البيانات التي تقف خلفها من محرر مسار البيانات أو عبر واجهة API — ليصبح لسؤال «ما الذي تعرضه هذه الواجهة فعلًا؟» جواب موثّق لا تخمين.

  • فهرسة نقاط نهاية API من مواصفات OpenAPI لديكم، جنبًا إلى جنب مع الجداول ولوحات المعلومات وخطوط المعالجة.
  • مسار بيانات على مستوى العمود من الأنظمة المصدرية إلى الجداول، يمتد إلى نقاط النهاية التي تربطونها به.
  • محرر مرئي لمسار البيانات، أو واجهة API، لتسجيل كل رابط وتصحيحه.
  • تحليل الأثر: قبل تعديل أي عمود، شاهدوا كل نقطة نهاية مرتبطة تعتمد عليه.
استكشفوا مسار البيانات

تصنيف نقاط النهاية

صنّفوا نقاط النهاية بالوسوم نفسها التي تستخدمونها لبياناتكم.

ينبغي أن تتحدث البيانات وواجهات API لغة تصنيف واحدة. ففي غوافا تَسِمون نقاط نهاية API بالتصنيفات والوسوم نفسها التي تستخدمونها لمجموعات البيانات والأعمدة — فتُسجَّل حساسية نقطة النهاية في دليل البيانات بجوار البيانات التي تقدّمها.

  • تصنيفات ووسوم على مجموعات البيانات والأعمدة ونقاط نهاية API، من مخطط تصنيف معتمد واحد.
  • ينقل كل مصطلح في معجم مصطلحات الأعمال وسومه المرتبطة: طبّقوا مصطلحًا مثل «رقم الهوية الوطنية» على نقطة نهاية فيأتي معه وسم البيانات الشخصية.
  • تسري الملكية على واجهات API كما تسري على الجداول ولوحات المعلومات وخطوط المعالجة.
  • تصنيفات لنقاط النهاية يمكنكم عرضها على المراجعين — بما يدعم ضوابط تصنيف البيانات في إطار المكتب الوطني لإدارة البيانات.
تعرّفوا على قدرات الحوكمة

عرض انكشاف واجهات API

اعرفوا أي نقاط النهاية موسومة بأنها عامة أو شخصية أو مالية

عرض لانكشاف واجهات API يُبرز نقاط النهاية الموسومة بأنها عامة أو شخصية أو مالية. فعندما يُطرح سؤال «أي واجهات API العامة لدينا تقدّم بيانات شخصية؟»، تنطلقون من الوسوم في دليل البيانات لديكم لا من بحث في جداول متفرقة.

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

الأسئلة الشائعة

ضعوا واجهات API لديكم بجوار بياناتكم في دليل البيانات

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