هذا المقال لمستوى: مبتدئ. لو دي أول مرة تسمع كلمة API، أو كتبت شوية بايثون بس عمرك ما بنيت سيرفر، انت في المكان الصح. مش هنفترض إنك تعرف حاجة عن الويب مسبقًا.
في آخر المقال هيكون عندك سيرفر بايثون شغّال بيرد على طلبات من النت، بيقرا ويحفظ بيانات، وبيولّد لنفسه صفحة توثيق تفاعلية — كل ده في أقل من 30 سطر كود.
اعمل أول REST API بـ FastAPI في بايثون
يعني إيه API أصلًا؟ (بمثال بسيط الأول)
تخيّل إنك قاعد في مطعم. انت مش بتدخل المطبخ وتطبخ بنفسك. انت بتنادي النادل، تقوله "عايز طبق كذا"، هو بيروح للمطبخ ويرجعلك بالأكل جاهز. انت معندكش فكرة إزاي اتطبخ، ومش محتاج تعرف.
الـ API هو النادل ده بالظبط. برنامج تاني (تطبيق موبايل مثلًا) بيقوله "هات لي بيانات المنتج رقم 5"، والـ API بيروح يجيبها من قاعدة البيانات ويرجّعها. الطرفين ما بيعرفوش تفاصيل بعض، بس بيتفقوا على طريقة الكلام.
دلوقتي التعريف العلمي: REST API هو واجهة بتخلّي برنامجين يتكلموا عبر بروتوكول HTTP باستخدام أفعال قياسية (GET للقراءة، POST للإضافة، PUT للتعديل، DELETE للحذف)، وكل مورد (منتج، مستخدم) له عنوان URL ثابت. النتيجة بترجع غالبًا كـ JSON، وهو صيغة نصية خفيفة كل اللغات بتفهمها.
ليه FastAPI بالذات؟
فيه أكتر من إطار في بايثون لبناء APIs: Django وFlask وFastAPI. تلاتتهم شغّالين، بس لكل واحد مقايضة.
استخدم FastAPI لو عايز تبدأ بسرعة وتكسب أداء عالي وتوثيق تلقائي. التكلفة: هتحتاج تفهم فكرة الـ type hints في بايثون، وإنه async بطبيعته. المكسب: التحقق من البيانات بيتعمل لوحده، وصفحة التوثيق بتتبني من غير ما تكتب سطر زيادة. حسب قياسات TechEmpower، FastAPI فوق Uvicorn بيقدر يخدم عشرات الآلاف من الطلبات في الثانية على سيرفر متوسط — أسرع بمراحل من Flask التقليدي المتزامن.
الخطوات: من صفر لسيرفر شغّال
- ثبّت المكتبة. افتح الترمنال واكتب الأمر ده. هو بيجيب FastAPI ومعاه سيرفر Uvicorn اللي هيشغّل الكود.
pip install "fastapi[standard]"- اكتب ملف اسمه
main.py. ده كل الكود المطلوب: endpoint بيقرا منتج، وendpoint بيحفظ منتج.
from fastapi import FastAPI
from pydantic import BaseModel
app = FastAPI()
# قاعدة بيانات مبسطة في الذاكرة (للتعلّم فقط)
products = {1: {"name": "كيبورد", "price": 350}}
# شكل البيانات المطلوبة عند الحفظ
class Product(BaseModel):
name: str
price: float
@app.get("/products/{product_id}")
def get_product(product_id: int):
return products.get(product_id, {"error": "المنتج غير موجود"})
@app.post("/products/{product_id}")
def save_product(product_id: int, product: Product):
products[product_id] = product.dict()
return {"saved": product_id, "data": product}