آموزش FastAPI با تورهام – قسمت هفتم – Query Parameters

در این قسمت از آموزش FastAPI با تورهام، به آموزش Query Parameters می‌پردازیم.

Query Parameters یکی از روش‌های ارسال داده‌ها به سرور است که از طریق URL انجام می‌شود. این داده‌ها به صورت key-value در URL قرار می‌گیرند و با استفاده از این داده‌ها می‌توانید مقدارهای مختلف را به سرور ارسال کنید.

برای ایجاد یک endpoint با Query Parameters در FastAPI، می‌توانید از دکوریتور @app.get استفاده کنید و Query Parameters مورد نیاز را به عنوان پارامتر‌های تابع مشخص کنید. برای مثال:

from fastapi import FastAPI

app = FastAPI()

@app.get("/items/")
async def read_item(q: str):
    return {"q": q}

در این مثال، ما یک endpoint با URL /items/ ایجاد کرده‌ایم که یک Query Parameter به نام q را از کاربر دریافت می‌کند و مقدار آنرا به عنوان JSON درخواست برمی‌گرداند.

برای تست این endpoint، می‌توانید از یک برنامه مانند Postman یا ابزارهای مشابه استفاده کرده و مقدار Query Parameter را در URL مشخص کنید، به عنوان مثال: /items/?q=example.

این یک نمونه ساده از استفاده از Query Parameters در FastAPI بود. شما می‌توانید پارامتر‌های دیگری را نیز استفاده کنید و به صورت پویا تغییرات لازم را در endpoint خود اعمال کنید.

امیدواریم که این آموزش مفید برای شما بوده باشد. برای آموزش‌های بیشتر در مورد FastAPI، به سایت رسمی آن مراجعه کنید.