دليل بناء وتطوير واجهات برمجة التطبيقات REST APIs الاحترافية بلغة بايثون عبر إطار عمل FastAPI فائق السرعة مع التوثيق التفاعلي التلقائي ونماذج Pydantic.
3 خطوات8 دقائق قراءةبواسطة Admin

تعتبر واجهات برمجة التطبيقات (APIs - Application Programming Interfaces) الجسور الرقمية الخفية التي تربط بين قواعد البيانات وأنظمة الباك إند وبين تطبيقات الهواتف الذكية وواجهات الويب؛ فهي التي تمكن تطبيق الهاتف من سحب المنتجات، وتسجيل حسابات المستخدمين، وإجراء عمليات الشراء بأمان وموثوقية عالية بصيغة JSON القياسية.
أصبح إطار عمل FastAPI في السنوات الأخيرة الخيار الأول والمفضل لكبرى شركات التكنولوجيا (مثل Microsoft و Uber و Netflix) لبناء خدمات الباك إند ونماذج الذكاء الاصطناعي بلغة Python؛ بفضل سرعته الاستثنائية التي تضاهي لغات Go و NodeJS، وتوليده التلقائي لصفحات التوثيق التفاعلية Swagger UI. نستعرض هنا خطوات بناء أول API متكامل في دقائق.
افتح التيرمينال وثبت إطار العمل وخادم التشغيل فائق السرعة عبر مدير الحزم: pip install fastapi "uvicorn[standard]"
أنشئ ملفاً باسم main.py واكتب الكود الأساسي البسيط: from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def home(): return {"message": "أهلاً بك في أول API سريع"}
شغل الخادم بكتابة: uvicorn main:app --reload، وافتح متصفحك على http://127.0.0.1:8000 لترى استجابة الـ JSON الفورية الخاطفة!
النتيجة المتوقعة: خادم باك إند محلي فائق السرعة يعمل بميزة إعادة التحميل التلقائي عند التعديل
السر الأكبر لقوة FastAPI هو التكامل التلقائي مع مكتبة Pydantic للتحقق من صحة مدخلات المستخدمين ومنع البيانات الخبيثة. أنشئ نموذجاً للبيانات: from pydantic import BaseModel
class Item(BaseModel):
title: str
price: float
in_stock: bool = True
ثم أنشئ مسار الإضافة POST: @app.post("/items")
def create_item(item: Item): return {"status": "تمت الإضافة", "data": item}
يقوم النظام بالتحقق التلقائي؛ فإذا أرسل الزائر نصاً في حقل السعر فسيقوم الخادم برفضه وعرض رسالة خطأ واضحة دون أي كود تحقق إضافي منك.
النتيجة المتوقعة: حماية أمنية تلقائية وضمان سلامة وتوافق أنواع البيانات المدخلة لقاعدة البيانات
أعظم وأروع ميزة في FastAPI هي التوثيق التفاعلي التلقائي؛ افتح متصفحك واكتب في شريط العنوان: http://127.0.0.1:8000/docs. ستظهر لك واجهة Swagger UI الساحرة تلقائياً؛ تعرض كافة المسارات التي كتبتها، مع زر "Try it out" الذي يتيح لك تجربة إرسال البيانات واستقبال الاستجابة واختبار الأخطاء مباشرة من المتصفح دون الحاجة لاستخدام برامج إضافية مثل Postman.
النتيجة المتوقعة: توثيق معتمد عالمياً مطابق لمعايير OpenAPI جاهز للمشاركة مع مطوري تطبيقات الموبايل
أخبرنا إذا تمكنت من إكمال الخطوات أو ما زلت بحاجة إلى مساعدة.
طريقة تعلم SQL وإدارة قواعد البيانات للمبتدئيندليل شامل لتعلم لغة الاستعلام الهيكلية SQL من الصفر، من صياغة جمل SELECT والشروط وحتى ربط الجداول عبر JOIN وتصميم قواعد البيانات العلائقية.
خارطة طريق تعلم جافاسكريبت JavaScript للمبتدئيندليل وخارطة طريق تعلم لغة جافاسكريبت JavaScript من الصفر للمبتدئين، من المفاهيم الأساسية ودوال ES6 الحديثة وحتى التعامل مع DOM وواجهات الـ APIs وبناء المشاريع.
طريقة تثبيت وإعداد Visual Studio Code للمبرمجيندليل تثبيت وتهيئة محرر الأكواد العالمي Visual Studio Code، وتثبيت أهم إضافات المطورين لتنسيق الأكواد وكشف الأخطاء واختصارات لوحة المفاتيح السحرية.