واجهة وصول موحّدة

واجهة REST API ولغة الاستعلام الشاملتان اللتان تمنحان التطبيقات طريقة واحدة وموحّدة للوصول إلى بيانات النظام ووظائفه.

واجهة REST API الشاملة

يطبّق النظام واجهة REST API شاملة توفّر تفاعلاً متّسقاً بين مختلف الأنظمة والتطبيقات والأجهزة. وهي تجرّد تفاصيل التنفيذ وتوفّر طريقة موحّدة للوصول إلى بيانات النظام ووظائفه.

تتميّز خدمة REST API بالخصائص التالية في التعامل مع البيانات:

  • التجانس: تتّبع جميع الطلبات والاستجابات الصيغة نفسها.
  • قابلية التوسّع: تدعم عدداً كبيراً من الأجهزة والمستخدمين.
  • الأمان: توفّر المصادقة والتفويض وتشفير البيانات.
  • التوثيق: لها توثيق واضح للمطوّرين.

تبسّط الخدمة بدرجة كبيرة العمل اللاحق مع البيانات:

  • تبسيط التكامل: يمكن للأنظمة والأجهزة المختلفة أن تتفاعل عبر واجهة واحدة.
  • تجريد العتاد: لا تعتمد التطبيقات على أجهزة أو بروتوكولات بعينها.
  • الإدارة المركزية: تمرّ جميع طلبات البيانات عبر نقطة دخول واحدة.
  • المرونة: يمكن إضافة ميزات جديدة أو تعديل الميزات القائمة بسهولة.

مثال على طلب عبر واجهة REST API الشاملة

طلب البيانات:

Request example
GET /api/v1/channel_data?equipment_id=1&archive_type=daily&channel_id=3

الاستجابة:

Response example
[
  {
    "id": 123,
    "equipment_id": 1,
    "seance_id": 2,
    "channel_id": 3,
    "archive_type_id": 4,
    "value": 42.5,
    "event_time": 1739950861
  }
]

مزايا واجهة REST API الشاملة

تُعدّ خدمة REST API أداة قوية تنشئ واجهة موحّدة للوصول إلى البيانات.

وهي تتيح لك:

  • التجريد عن الأجهزة والتقنيات المحدّدة.
  • ضمان الاتّساق وسهولة الاستخدام.
  • تبسيط تكامل الأنظمة والأجهزة الجديدة.

لغة الاستعلام

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

توفّر لغة الاستعلام الإمكانات التالية:

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

أمثلة على لغات الاستعلام المستخدمة في النظام

SQL (لغة الاستعلام البنيوية)

يستخدم نظام إدارة قواعد البيانات PostgreSQL لغة الاستعلام SQL للعمل مع البيانات. وهي تدعم عمليات معالجة البيانات الأساسية.

مثال على استعلام SQL لاسترجاع البيانات:

example.sql
SELECT id, channel_id, value
FROM channel_data
WHERE equipment_id = 1 AND archive_type_id = 4;

واجهة REST مع معاملات

تطبّق واجهة REST API الشاملة واجهة REST مزوّدة بمعاملات كجزء من تفاعلها مع البيانات. وهذا يتيح لواجهة API استخدام معاملات الاستعلام لتصفية البيانات.

على سبيل المثال:

Request example
GET /api/v1/channel_data?equipment_id=1&channel_id=101

واجهة استعلام Active Record

يطبّق إطار العمل Ruby on Rails آلية Active Record (واجهة استعلام Active Record)، التي تتيح لك الاستعلام من قواعد البيانات دون استخدام SQL.

وفيما يلي مثال على استعلام Active Record لاسترجاع البيانات:

Active record example
ChannelDatum.where(equipment_id: 1, archive_type_id: 4)

مواضيع ذات صلة

آخر تحديث في

هل كانت هذه الصفحة مفيدة؟

اكتب للبحث في التوثيق

↑↓ للتنقل
Esc