FastAPI

FastAPI: دليل شامل للمبتدئين

FastAPI هو إطار عمل (framework) تطوير ويب حديث وعالي الأداء، مبني على Python 3.7+، ويستخدم لإنشاء واجهات برمجة تطبيقات (APIs) بسرعة وسهولة. يتميز بالسرعة والكفاءة، ويعتمد على معايير مفتوحة مثل OpenAPI و JSON Schema. في عالم تداول العملات المشفرة، يمكن استخدام FastAPI لبناء منصات تداول، وواجهات لمراقبة العقود الآجلة، وأنظمة إدارة المخاطر، وغيرها من التطبيقات الحيوية. هذه المقالة موجهة للمبتدئين وتهدف إلى توفير فهم شامل لـ FastAPI وكيفية استخدامه.

لماذا FastAPI؟

قبل الخوض في التفاصيل، دعنا نستعرض الأسباب التي تجعل FastAPI خيارًا جذابًا لتطوير الـ API:

• الأداء العالي: FastAPI مبني على Starlette و Pydantic، وهما مكتبتان Python عاليتا الأداء. هذا يجعله أسرع من العديد من أطر العمل الأخرى، بما في ذلك Flask و Django، خاصة في معالجة الطلبات المتزامنة. هذا الأداء بالغ الأهمية في تطبيقات تداول العملات المشفرة التي تتطلب معالجة سريعة لكميات كبيرة من البيانات.
• سهولة الاستخدام: FastAPI مصمم ليكون سهل الاستخدام للغاية، مع التركيز على تجربة المطور. يوفر توثيقًا شاملاً وأمثلة واضحة، مما يجعله نقطة انطلاق ممتازة للمبتدئين.
• التوثيق التلقائي: FastAPI يولد تلقائيًا توثيق API تفاعلي باستخدام OpenAPI (Swagger UI) و ReDoc. هذا يوفر الوقت والجهد في إنشاء وصيانة التوثيق، وهو أمر ضروري للتعاون بين المطورين واستخدام API من قبل أطراف ثالثة.
• التحقق من البيانات: يستخدم FastAPI مكتبة Pydantic للتحقق من صحة البيانات المدخلة والمخرجة. هذا يضمن أن بياناتك متوافقة مع التوقعات ويقلل من الأخطاء.
• اعتماد على الأنواع (Type Hints): يعتمد FastAPI بشكل كبير على الأنواع في Python، مما يحسن من قابلية قراءة الكود وصيانته. كما يساعد أدوات التحليل الثابت (static analysis) مثل MyPy في اكتشاف الأخطاء في وقت مبكر.
• دعم متزامن وغير متزامن: FastAPI يدعم كل من العمليات المتزامنة وغير المتزامنة، مما يتيح لك الاستفادة من قوة البرمجة غير المتزامنة لتحسين الأداء.

المتطلبات الأساسية

قبل البدء، تأكد من أن لديك المتطلبات الأساسية التالية:

• Python 3.7+ مثبت على جهازك.
• pip، مدير الحزم الخاص بـ Python.
• معرفة أساسية بـ Python، بما في ذلك الدوال، الفئات، وأنواع البيانات.
• فهم أساسي لمفاهيم الـ API (واجهات برمجة التطبيقات) و HTTP.

التثبيت

لتثبيت FastAPI، استخدم الأمر التالي في سطر الأوامر:

Admin (نقاش)bash pip install fastapi uvicorn Admin (نقاش)

• fastapi هو إطار العمل نفسه.
• uvicorn هو خادم ASGI (Asynchronous Server Gateway Interface) الذي يستخدم لتشغيل تطبيق FastAPI.

أول تطبيق FastAPI

دعنا ننشئ تطبيق FastAPI بسيطًا:

1. أنشئ ملفًا باسم `main.py`. 2. أضف الكود التالي إلى الملف:

Admin (نقاش)python from fastapi import FastAPI

app = FastAPI()

@app.get("/") async def read_root():

   return {"Hello": "World"}

@app.get("/items/{item_id}") async def read_item(item_id: int, q: str = None):

   return {"item_id": item_id, "q": q}

Admin (نقاش)

3. شغل التطبيق باستخدام الأمر التالي:

Admin (نقاش)bash uvicorn main:app --reload Admin (نقاش)

• `main` هو اسم الملف (بدون اللاحقة `.py`).
• `app` هو اسم المتغير الذي يحتوي على كائن FastAPI.
• `--reload` يسمح للخادم بإعادة التحميل تلقائيًا عند إجراء تغييرات على الكود.

الآن، افتح متصفحك وانتقل إلى `http://127.0.0.1:8000/`. يجب أن ترى `{"Hello": "World"}`. يمكنك أيضًا الانتقال إلى `http://127.0.0.1:8000/docs` لرؤية التوثيق التلقائي لـ API الخاص بك (Swagger UI).

المفاهيم الأساسية في FastAPI

• التطبيقات (Applications): هو نقطة الدخول الرئيسية لتطبيق FastAPI. يتم إنشاء التطبيق باستخدام `FastAPI()`.
• المسارات (Routes): تحدد نقاط النهاية (endpoints) لـ API. يتم تعريف المسارات باستخدام decorators مثل `@app.get()`, `@app.post()`, `@app.put()`, `@app.delete()`.
• دوال المسار (Path Operations): هي الدوال التي يتم استدعاؤها عند الوصول إلى مسار معين. تحدد هذه الدوال كيفية معالجة الطلب وإرجاع الاستجابة.
• الطلبات (Requests): هي البيانات التي يرسلها العميل إلى الخادم. يمكن الوصول إلى بيانات الطلب من خلال معلمات دالة المسار.
• الاستجابات (Responses): هي البيانات التي يرسلها الخادم إلى العميل. يمكن إرجاع الاستجابات كـ JSON، نص عادي، HTML، أو أي تنسيق آخر.
• Pydantic Models: تستخدم Pydantic لتعريف هياكل البيانات المستخدمة في الطلبات والاستجابات. يسمح هذا بالتحقق من صحة البيانات وضمان التوافق.

أمثلة متقدمة

1. 1. 1. 1. التعامل مع بيانات POST

لنفترض أننا نريد إنشاء نقطة نهاية لقبول بيانات جديدة.

Admin (نقاش)python from fastapi import FastAPI, Body from pydantic import BaseModel

app = FastAPI()

class Item(BaseModel):

   name: str
   description: str | None = None
   price: float
   tax: float | None = None

@app.post("/items/") async def create_item(item: Item):

   return item

Admin (نقاش)

في هذا المثال:

• نستخدم `BaseModel` من Pydantic لتعريف هيكل البيانات `Item`.
• نستخدم `Body` من FastAPI لتحديد أننا نتوقع بيانات في نص الطلب (request body).
• تقوم دالة `create_item` بإرجاع البيانات التي تم إرسالها.

1. 1. 1. 1. استخدام معلمات الاستعلام (Query Parameters)

```python from fastapi import FastAPI

app = FastAPI()

@app.get("/items/") async def read_items(q: str | None = None, skip: int = 0, limit: int = 10):

   return {"q": q, "skip": skip, "limit": limit}

```

• `q` هو معلمة استعلام اختيارية (اختياري). إذا لم يتم توفيرها، ستكون قيمتها `None`.
• `skip` و `limit` هما معلمات استعلام إلزامية مع قيم افتراضية.

1. 1. 1. 1. استخدام متغيرات المسار (Path Parameters)

```python from fastapi import FastAPI

app = FastAPI()

@app.get("/items/{item_id}") async def read_item(item_id: int):

   return {"item_id": item_id}

```

• `item_id` هو متغير مسار. يجب أن يكون عددًا صحيحًا.

1. 1. 1. 1. التعامل مع الأخطاء

يمكنك استخدام `HTTPException` من FastAPI للتعامل مع الأخطاء.

```python from fastapi import FastAPI, HTTPException

app = FastAPI()

@app.get("/items/{item_id}") async def read_item(item_id: int):

   if item_id == 0:
       raise HTTPException(status_code=404, detail="Item not found")
   return {"item_id": item_id}

```

FastAPI وتداول العملات المشفرة

FastAPI مثالي لبناء تطبيقات في مجال تداول العملات المشفرة. إليك بعض الأمثلة:

• واجهات برمجة تطبيقات التداول: بناء واجهات تتيح للمستخدمين شراء وبيع العملات المشفرة.
• مراقبة الأسعار: إنشاء واجهات تعرض أسعار العملات المشفرة في الوقت الفعلي من مصادر مختلفة. هذا يتطلب التكامل مع واجهات برمجة تطبيقات البورصات مثل Binance و Coinbase.
• إدارة المخاطر: تطوير أنظمة لمراقبة وتقييم المخاطر المرتبطة بتداول العملات المشفرة.
• تحليل البيانات: بناء واجهات لمعالجة وتحليل بيانات تداول العملات المشفرة.
• إشارات التداول: إنشاء أنظمة تولد إشارات تداول بناءً على التحليل الفني و التحليل الأساسي.
• Backtesting: بناء أدوات لاختبار استراتيجيات التداول على بيانات تاريخية.

استراتيجيات التداول والتحليل الفني

يمكن لـ FastAPI أن يكون العمود الفقري لتطبيقات تستخدم استراتيجيات تداول متطورة، مثل:

• المتوسطات المتحركة
• مؤشر القوة النسبية (RSI)
• مؤشر الماكد (MACD)
• بولينجر باندز
• نماذج الشموع اليابانية
• تحليل حجم التداول
• التحليل الموجي إليوت
• تصحيح فيبوناتشي
• مؤشر ستوكاستيك
• مؤشر التجميع والتوزيع (A/D)
• مؤشر تدفق الأموال (MFI)
• استراتيجية الاختراق
• استراتيجية الارتداد
• استراتيجية التداول المتأرجح
• استراتيجية التداول اليومي

التكامل مع قواعد البيانات

FastAPI يمكن دمجه بسهولة مع قواعد البيانات المختلفة، مثل:

• PostgreSQL
• MySQL
• MongoDB
• Redis

يمكن استخدام مكتبات مثل SQLAlchemy و Databases لتسهيل عملية التكامل.

الخلاصة

FastAPI هو إطار عمل قوي ومرن لتطوير واجهات برمجة تطبيقات Python. بفضل أدائه العالي وسهولة استخدامه، فهو خيار ممتاز لتطبيقات تداول العملات المشفرة وغيرها من التطبيقات التي تتطلب معالجة سريعة للبيانات. من خلال فهم المفاهيم الأساسية والتعمق في الميزات المتقدمة، يمكنك بناء تطبيقات قوية وفعالة تلبي احتياجاتك.

منصات تداول العقود الآجلة الموصى بها

المنصة	مميزات العقود الآجلة	التسجيل
Binance Futures	رافعة مالية تصل إلى 125x، عقود USDⓈ-M	سجّل الآن
Bybit Futures	عقود دائمة عكسية	ابدأ التداول
BingX Futures	التداول بالنسخ	انضم إلى BingX
Bitget Futures	عقود مضمونة بـ USDT	افتح حساب
BitMEX	منصة العملات المشفرة، رافعة مالية تصل إلى 100x	BitMEX

انضم إلى مجتمعنا

اشترك في قناة Telegram @strategybin للحصول على المزيد من المعلومات. أفضل منصات الربح – اشترك الآن.

شارك في مجتمعنا

اشترك في قناة Telegram @cryptofuturestrading للحصول على التحليل، الإشارات المجانية والمزيد!