فئات الموارد وكائن Api
نمذج نقاط النهاية كموارد ذات أفعال HTTP.
فئات الموارد وكائن Api درس مجاني في Flask Academy على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Flask Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Flask Academy 4 دروس في المجموع.
بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.
A Cleaner Way to Build APIs
Plain Flask routes work, but for APIs Flask-RESTful gives you a tidy, class-based structure that scales as endpoints grow. 🧩
Install the Extension
Flask-RESTful ships separately. Add it to your project with pip before you import anything from it.
pip install flask-restfulImport the Pieces
You need two names: Api, the manager that wires endpoints, and Resource, the base class for each one.
from flask_restful import Api, ResourceWrap Your App in an Api
Create an Api object around your Flask app. It becomes the registry where every resource gets mounted.
app = Flask(__name__)
api = Api(app)What a Resource Is
A Resource is a Python class representing one thing in your API, like a task or a user, grouped in one place.
class HelloWorld(Resource):
passSubclass Resource
Every endpoint you build starts by subclassing Resource. Methods inside it will answer HTTP verbs.
class TaskList(Resource):
def get(self):
return {"tasks": []}Mount It on a URL
Use add_resource to attach a resource class to a URL path. That is how the Api learns where it lives.
api.add_resource(TaskList, "/tasks")Return Plain Dicts
Just return a Python dict and Flask-RESTful serializes it to JSON for you, no manual jsonify needed. ✨
def get(self):
return {"message": "hello"}No More Route Decorators
Notice you skipped @app.route entirely. The Api object and add_resource replace the decorator workflow.
Run It Like Any Flask App
Startup is unchanged: the same app.run serves your resource-based API on the dev server.
if __name__ == "__main__":
app.run(debug=True)Why Classes Help
Grouping related verbs in one class keeps each endpoint self-contained and far easier to read than scattered functions.
Quick Check
Which object connects a Resource class to a URL?
Recap: Resources and the Api
You wrapped your app in an Api, subclassed Resource, and mounted it with add_resource. A clean API skeleton! 🎉
الأسئلة الشائعة
هل درس «فئات الموارد وكائن Api» مجاني؟
نعم — نص درس «فئات الموارد وكائن Api» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Flask Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Flask Academy 4 دروس في المجموع.
ماذا ستتعلم في «فئات الموارد وكائن Api»؟
نمذج نقاط النهاية كموارد ذات أفعال HTTP. تتمرن على Flask Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Flask Academy؟
لا تُشترط خبرة سابقة. Flask Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.
كم من الوقت يستغرق درس «فئات الموارد وكائن Api»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Flask Academy هذا؟
نعم. كل درس في Flask Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- فئات الموارد وكائن Api
- ربط أساليب HTTP بمعالجات الفئات
- تحليل المدخلات والتحقق منها باستخدام reqparse
- موارد REST المثبّتة على Blueprint