نقطة API الأولى
تعلّموا إنشاء نقاط نهاية GET بسيطة، وتعريف المسارات، وإرجاع استجابات JSON أساسية.
نقطة API الأولى درس مجاني في FastAPI Backend Development Bootcamp على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في FastAPI Backend Development Bootcamp، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة FastAPI Backend Development Bootcamp 4 دروس في المجموع.
بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.
What's an API Endpoint?
An API endpoint is a specific URL your API exposes — an address that receives requests and returns a service. We start with GET, used to fetch data.
Your FastAPI Application
Every app starts from a FastAPI instance, conventionally named app. This object is the core where all your routes and logic live.
from fastapi import FastAPI
app = FastAPI()
# This 'app' object is where your API lives!Defining Routes with Decorators
FastAPI uses decorators to bind a URL path to a function. @app.get("/") says: on a GET to the root path, run the function below.
Your First 'Hello World' Endpoint
Here is the classic API Hello World — a single GET endpoint at /. Run it and hit the root in your browser or Postman.
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
return {"message": "Hello, CoddyKit!"}
# To run: Save as main.py, then 'uvicorn main:app --reload'Running Your FastAPI App
Run your app with Uvicorn: uvicorn main:app --reload finds app in main.py and auto-restarts whenever you edit code.
FastAPI's JSON Magic
FastAPI's JSON magic: return a Python dict or list and it serializes to a JSON response automatically — no manual conversion needed.
Returning Structured JSON Data
Return a richer Python dict and FastAPI ships it as structured JSON. Here, an endpoint hands back full product details.
from fastapi import FastAPI
app = FastAPI()
@app.get("/product")
def get_product_info():
return {
"id": "CK001",
"name": "CoddyKit Pro Course",
"price": 49.99,
"available": True
}
# Run with: uvicorn main:app --reload
# Access this endpoint at /productCreating Multiple Endpoints
An API has many endpoints, each for a different resource. Define as many as you need on one app — here, two distinct GET routes.
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
return {"message": "Welcome to our API!"}
@app.get("/items")
def get_items():
return [
{"id": 1, "name": "Laptop"},
{"id": 2, "name": "Mouse"},
{"id": 3, "name": "Keyboard"}
]
# Run with: uvicorn main:app --reload
# Access at / and /itemsEndpoint Naming Conventions
Good endpoint naming keeps an API readable: plural nouns for collections, short lowercase hyphenated paths, and no verbs — the HTTP method implies the action.
Quick Check
Which of the following code snippets correctly defines a FastAPI GET endpoint at the path /status that returns a JSON object {"status": "OK"}?
Lesson Summary
Solid! You built endpoints with decorators, returned dicts as JSON, and ran the app via Uvicorn. Next: making routes dynamic with URL data.
الأسئلة الشائعة
هل درس «نقطة API الأولى» مجاني؟
نعم — نص درس «نقطة API الأولى» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة FastAPI Backend Development Bootcamp، انتقل إلى CoddyKit PRO. تتضمن دورة FastAPI Backend Development Bootcamp 4 دروس في المجموع.
ماذا ستتعلم في «نقطة API الأولى»؟
تعلّموا إنشاء نقاط نهاية GET بسيطة، وتعريف المسارات، وإرجاع استجابات JSON أساسية. تتمرن على FastAPI Backend Development Bootcamp مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ FastAPI Backend Development Bootcamp؟
لا تُشترط خبرة سابقة. FastAPI Backend Development Bootcamp على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.
كم من الوقت يستغرق درس «نقطة API الأولى»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس FastAPI Backend Development Bootcamp هذا؟
نعم. كل درس في FastAPI Backend Development Bootcamp يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- مقدمة إلى FastAPI وإعداده
- نقطة API الأولى
- معلمات المسار والاستعلام
- مستندات API التفاعلية باستخدام Swagger UI