ربط فلاتر بالخادم باستخدام Dio: النماذج والأخطاء والبنية النظيفة
كل تطبيق حقيقي يتواصل مع واجهة API. يوضح هذا الدليل كيف ترسل الطلبات باستخدام Dio، وتحوّل الاستجابات إلى نماذج Dart، وتعالج الأخطاء بشكل صحيح، وتُبقي شيفرة الشبكة في طبقة نظيفة.
أن تصبح مطوّرًا شاملًا (full-stack) بفلاتر وFastAPI أمر ممكن تمامًا. يعرض هذا المقال خريطة الطريق من أول نقطة نهاية ونماذج Pydantic إلى PostgreSQL والترحيلات والنشر بـ Docker.

إذا كنت تعرف فلاتر، فتعلّم تطوير الخادم يحوّلك من «مطوّر تطبيقات» إلى «صانع منتجات». وFastAPI خيار ممتاز لذلك: سريع وحديث، مع توثيق تلقائي، وقريب من Dart في طريقة استخدام الأنواع.
from fastapi import FastAPI
from pydantic import BaseModel
app = FastAPI()
class Course(BaseModel):
id: int
name: str
price: int
@app.get("/api/v1/courses", response_model=list[Course])
async def list_courses():
return [Course(id=1, name="Flutter", price=4900000)]شغّله بـ uvicorn main:app --reload وافتح /docs.
لاستقبال البيانات من التطبيق عرّف نموذج Pydantic. ويرفض FastAPI البيانات غير الصالحة برسالة خطأ واضحة تلقائيًا:
class OrderIn(BaseModel):
name: str
phone: str
description: str | None = None
@app.post("/api/v1/orders", status_code=201)
async def create_order(data: OrderIn):
...لتخزين البيانات، PostgreSQL خيار موثوق وSQLAlchemy (غير المتزامن) طبقة الوصول. ولتغيير بنية الجداول مع الوقت استخدم Alembic، فيصبح كل تغيير ترحيلًا (migration) بإصدار يُطبَّق على الخادم بأمر واحد:
alembic revision --autogenerate -m "add orders table"
alembic upgrade headالمبدأ نفسه الذي تعلّمته في فلاتر ينطبق هنا: الموجّه (router) يستقبل الطلب ← الخدمة (service) منطق العمل ← المستودع/ORM الوصول إلى البيانات. لا تكتب المنطق داخل الموجّه.
ابدأ المسارات بـ /api/v1/.... وعندما تتغير البنية يومًا ما تنشئ v2، وتستمر الإصدارات القديمة من تطبيقك في العمل؛ وهذا مهم لأن المستخدمين لا يحدّثون جميعًا.
في جهة فلاتر يكفي النموذج نفسه وDio من المقال السابق. ولأن Pydantic يمنح الاستجابات شكلًا ثابتًا، يبقى fromJson بسيطًا.
1) بايثون وasync، 2) FastAPI وPydantic، 3) SQL وPostgreSQL، 4) المصادقة، 5) Docker والنشر. بعد ذلك تستطيع بناء أي تطبيق فلاتر بنفسك من البداية إلى النهاية.
يبني فريق فست فلاتر تطبيقات أندرويد وiOS والويب وسطح المكتب والمواقع بفلاتر: تقدير فوري بالدولار، ودفع على مراحل، والشيفرة المصدرية كاملة.