URI API و URL API: ما الفرق؟

هناك العديد من الاختصارات المختلفة التي تصف عددًا هائلًا من المصطلحات في عالم الكمبيوتر، لذا فإن معرفة وفهم كل واحدة منها لم يكن أكثر أهمية من أي وقت مضى. إذا سألك شخص ما ما الفرق بين API URI و API URL، هل يمكنك الإجابة عليه على الفور؟

قبل المقارنة بين مصطلحي API (واجهة برمجة التطبيقات) المذكورين سابقًا، دعنا نتعمق أكثر في كل واحد منهما.

ما هو API URI؟

API URI (معرف الموارد الموحد) هو عنوان محدد مطلوب لتحديد المواقع والتفاعل مع الموارد داخل API معين. بعبارة أخرى، هو العنوان الفريد لقطعة معينة من المعلومات الموجودة داخل API.

تركيب API URI

• البروتوكول: يحدد البروتوكول كيفية التواصل مع API، وعادة ما يكون HTTP (بروتوكول نقل النص الفائق) أو HTTPS (HTTP المؤمّن). على سبيل المثال، https:// في https://api.example.com/users.
• المضيف: يمكن أن يحدد المضيف الخادم الذي تتواجد فيه API، مثل api.example.com في المثال أعلاه.
• المسار: يحدد المسار موردًا معينًا داخل API، وغالبًا ما يبدأ بشرطة مائلة (/). على سبيل المثال، قد يشير مسار مثل /users إلى مجموعة من بيانات المستخدمين. أحيانًا، تحدد مكونات المسار مزيدًا من العناصر المحددة داخل المورد، مثل /users/123 لمستخدم يحمل ID 123.
• سلسلة الاستعلام (اختياري): توفر سلاسل الاستعلام معلمات إضافية لتصفية أو تحسين المورد، وعادة ما تتبع علامة استفهام (?) وتتكون من أزواج مفتاح-قيمة مفصولة بعلامات (&) (&). على سبيل المثال، /users?name=John قد يؤدي إلى استرجاع مستخدمين باسم John.

مثال على API URI

إليك بعض الأمثلة على API URIs في سيناريوهات مختلفة، مع أوصاف تخبرك بما يحدث:

• استرجاع جميع المستخدمين في نظام:
  https://api.example.com/users (يستخدم بروتوكول HTTPS، الوصول إلى مصدر "المستخدمين" على "api.example.com")
• الحصول على تفاصيل مستخدم محدد لديه ID 123:
  https://api.example.com/users/123 (الوصول إلى المستخدم الذي يحمل ID 123 داخل مورد "المستخدمين")
• البحث عن مستخدمين يحملون اسم "John":
  https://api.example.com/users?name=John (استخدام معلمة استعلام لتصفية الاسم)

الآن بعد أن أصبح الأمر أوضح ما هو API URI، دعنا ننتقل إلى API URLs!

ما هو API URL؟

API URL (محدد موقع البيانات الموحد) هو العنوان المحدد الذي يستخدمه مطورو الويب للوصول والتفاعل مع بيانات أو وظائف معينة داخل API.

لعملية أكثر سهولة، يمكنك التفكير في API URLs على أنها على نفس الشاكلة بالضبط مثل API URI. ومع ذلك، تذكر أن هناك بعض الفروق الصغيرة بين URIs و URLs، والتي سنشير إليها في المقالة أدناه.

تتبع API URLs نفس الهيكل مثل API URI، حيث يمكنك العثور على بروتوكول، مضيف، مسار، وسلسلة استعلام اختياري.

ملاحظات مثيرة حول API URLs

هناك بعض النقاط الأخرى التي يجب أن تتذكرها عند الحديث عن API URLs، مثل ما يلي:

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

أمثلة على API URLs

إليك بعض الأمثلة من الحياة الواقعية على API URLs التي قد تكون رأيتها من قبل، مع وصف قصير لما يحدث:

• GitHub: https://api.github.com/users/Bard (يسترجع معلومات عن المستخدم "Bard")
• OpenWeatherMap: https://api.openweathermap.org/data/2.5/weather?q=London (يحصل على بيانات الطقس في لندن)
• Unsplash: https://api.unsplash.com/photos/random?count=1 (يسترجع صورة عشوائية واحدة)
• Spotify: https://api.spotify.com/v1/tracks/7DIc5T4L54qeJrQ7zfnkzL (يحصل على معلومات عن مسار محدد)

الآن بعد رؤية API URIs و API URLs، هل ترى فرقًا واضحًا؟

الفرق التقني بين API URIs و API URLs

إليك جدول يصف الفجوات الدقيقة بين API URI و API URL. الفروق بينهما بسيطة جدًا، لذا قد تحتاج إلى مزيد من الوقت لتعتاد عليها.

منصة تطوير API تركز على التصميم - Apidog

Apidog هي منصة تطوير API كاملة وشاملة تتيح للمطورين تصميم وتصحيح واختبار وتوثيق ومحاكاة APIs. إنها تغطي دورة حياة API بالكامل - مثالية لمطوري الويب الذين يحتاجون إلى نفحة من الهواء النقي.

يوفر واجهة مستخدم نظيفة وبديهية في Apidog (واجهة المستخدم) للمطورين الجدد القدرة على تعلم كيفية التنقل واستخدام الوظائف القوية المختلفة لـ Apidog بسرعة.

استيراد ملفات API الخاصة بك إلى Apidog

إذا كانت لديك API موجودة ترغب في البدء في تحريرها أو تصحيحها على الفور، يمكنك استيرادها إلى Apidog!

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

اختبار نقاط نهاية API (أو API URLs) باستخدام Apidog

يمكننا اختبار ما إذا كانت نقاط نهاية API الخاصة بك تعمل بشكل طبيعي عن طريق إرسال طلب باستخدام Apidog. بمجرد استيراد ملفاتك إلى Apidog، يجب أن تكون قادرًا على رؤية شاشتك بشيء مشابه للصورة أدناه:

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

ثم، يمكنك إرسال الطلب عن طريق النقر على الزر المشار إليه بالسهم 2، ولكن تأكد من أنك قد اخترت البيئة الصحيحة أو أدخلت عنوان API URL الصحيح.

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

الخلاصة

API URIs و API URLs متشابهتان جدًا من حيث الهيكل، لذا يعتبر العديد منها أساسًا نفس الشيء لتبسيط الأمور. ومع ذلك، يجب أن تكون على علم بالفروق التقنية التي يمتلكها كل منهما، حيث قد لا تحل إحداهما محل الأخرى في جميع الحالات.

Apidog هي منصة تطوير API شاملة تلبي احتياجات العديد من مطوري الويب. يمكنك تصحيح وتصميم وبناء APIs سواء كفرد أو كفريق باستخدام Apidog.