واجهات برمجة التطبيقات (API) وبيانات JSON: الطلب ورموز الحالة 200 و404
APIs and JSON Data
الجواب المختصر
واجهة برمجة التطبيقات (API) نقطة دخول رسمية يستطيع النظام من خلالها طلب بيانات محددة والحصول على استجابة منظمة، غالبًا JSON. عند كتابة عنوان الواجهة في المتصفح يذهب طلب HTTP GET إلى الخادم، ويمكن لبرنامج بايثون إرسال الطلب نفسه، وقد تُضاف ترويسة وكيل المستخدم (User-Agent) لأن بعض الخوادم ترفض الطلبات من برامج مجهولة. وأهم خطوة بعد الطلب فحص رمز الحالة: 200 يعني نجاح الطلب.
رموز الحالة المهمة
| الرمز | المعنى | ماذا يفعل البرنامج؟ |
|---|---|---|
| 200 | الطلب ناجح | يحوّل نص JSON إلى كائن ويقرأ الحقول المهمة |
| 404 | المورد غير موجود (مثل رمز بريدي غير معروف) | يعرض رسالة واضحة بأن الرمز غير صحيح أو غير مدعوم |
| 400 | طلب غير صحيح | يعالج الخطأ |
| 401 | لا توجد صلاحية | يعالج الخطأ |
| 500 | خطأ داخل الخادم | يعرض رسالة عامة بوجود مشكلة |
شكل الرد
عند النجاح يعيد الخادم JSON منظمًا: حقل عام status يوضح النجاح، وكائن داخلي result فيه القيم التي تهم التطبيق (الرمز البريدي، البلد، المنطقة، خطي العرض والطول). يمكن تخزينه في قاعدة بيانات أو رسمه على خريطة أو استخدامه لتحليل توزيع الطلبات. وتُحاط الاستدعاءات عادةً بمعالجة الأخطاء للتعامل مع انقطاع الإنترنت أو انتهاء المهلة.
ميزة الواجهات على الملفات اليدوية أنها تقدم بيانات مستمرة ومحدثة ومستقرة. وانظر تنسيقات البيانات واستخراج البيانات من الويب واختيار المصادر الموثوقة.
وتذكّر أن بعض الواجهات تتطلب مفتاحًا أو تحدّ عدد الطلبات؛ اقرأ وثائقها قبل الاعتماد عليها.
المصطلحات: عربي ↔ English
- واجهة برمجة التطبيقات
- API
- رمز حالة HTTP
- HTTP Status Code
- وكيل المستخدم
- User-Agent
- JSON
- JSON
لماذا يهمّ هذا في BTEC؟
الفحص قبل الاستخدام هو ما يمنع الأعطال: لا تقرأ حقول النتيجة قبل التأكد أن الطلب نجح.
أسئلة تجيب عنها هذه الصفحة
- ما هو الـ API؟
- ما معنى رمز الحالة 404 و200؟
مفاهيم مرتبطة
- تنسيقات البيانات CSV وJSON وXML: المزايا والعيوب ومتى نختار كلًّا منها؟CSV أبسط تنسيق جدولي وخفيف، وJSON يمثل الهياكل المتداخلة وهو السائد في واجهات الويب، وXML واضح ومدعوم بمخططات تحقق لكنه أثقل. الاختيار يعتمد على طبيعة البيانات وحجمها ومصدرها وسهولة التكامل.
- استخراج البيانات من الويب (Web Scraping) وبيانات المنتديات: الخطوات والضوابطبيانات الويب غير مهيكلة للمستخدم وشبه مهيكلة للمبرمج لأن وسوم HTML تعمل كمفاتيح. خطوات الاستخراج: تحديد الموقع والبيانات، فحص بنية الصفحة، جلب الصفحة برمجيًا، تحليل الوسوم، ثم التنظيف والتخزين، مع احترام شروط الموقع وrobots.txt والخصوصية.
- كيف نختار مصادر بيانات مناسبة وموثوقة لمشروع الذكاء الاصطناعي؟نبدأ بتحديد هدف المشروع، ثم نراجع ما تملكه المؤسسة داخليًا قبل شراء بيانات خارجية، ثم نقيّم المصدر بمعايير: الحداثة، والاكتمال، والدقة، والتغطية، والجوانب القانونية والأخلاقية، والكلفة، ثم نجرّب بتجربة صغيرة قبل الاستثمار الكبير.
- مصادر البيانات في مشاريع الذكاء الاصطناعي: الأنظمة الداخلية والحساسات والويب والبيانات المفتوحةأبرز مصادر بيانات الذكاء الاصطناعي في المؤسسة: أنظمة المعاملات الداخلية، وأجهزة الحساسات وإنترنت الأشياء، وتفاعل المستخدمين مع التطبيقات، والمستندات والأرشيف، والبيانات المفتوحة الحكومية، والويب ومواقع التواصل.
- الفرق بين API وLibrary وSDK: كيف يتواصل التطبيق مع الجهاز؟API واجهة تواصل بين التطبيق ونظام التشغيل أو بين تطبيقين، والمكتبة (Library) مجموعة أكواد جاهزة، وSDK حزمة شاملة تضم الأدوات والمكتبات والوثائق والمحاكيات. التطبيق لا يعمل بمعزل عن الجهاز بل عبر طبقات منظمة تضمن الأمان.
عن كاتب الصفحة
مدرّس BTEC IT · الأردن
- نوع المحتوى
- شرح مبني على مادة أحمد دومي — وليس نصًّا رسميًّا من Pearson
- آخر مراجعة
- المصدر
- مدخل إلى الذكاء الاصطناعي وتطبيقاته — كتاب الوحدة (أحمد دومي) — الصفحات 22–24، 70