FastAPI bugungi kunda Python ekotizimidagi eng tez rivojlanayotgan web framework'lardan biriga aylandi va bu heç qanday tasodif emas. U async dasturlaş, zamonaviy Python tip belgilari (type hints) va avtomatik hujjatlaş imkoniyatlarini bitta vositada birlaştirib, dasturçilarga ham qulay, ham ğoyat samarali API quriş imkonini beradi. Agar siz Python'da REST API yozmoqçi bölsangiz va Flask yoki Djangöga zamonaviy alternativa izlayotgan bölsangiz, FastAPI deyarli har doim eng yaxşi tanlov hisoblanadi. Uşbu maqolada uning asosiy ğoyalari, amaliy kod misollari va boşqa framework'lardan farqini batafsil körib çiqamiz.
FastAPI nima va nega u maşhur
FastAPI — bu Python 3.7 va undan yuqori versiyalar uçun möljallangan, yuqori unumdorlikka ega zamonaviy web framework bölib, u Starlette (web qatlami uçun) va Pydantic (ma'lumotlarni tekşiriş uçun) kutubxonalari ustiga qurilgan. Uning eng katta ustunligi tezlikdir: FastAPI Node.js va Go bilan taqqoslanadigan darajada tez işlaydi, çunki u async/await mexanizmidan töliq foydalanadi va sörovlarni bloklamasdan parallel qayta işlaydi. Bundan taşqari, framework kodni yoziş vaqtini sezilarli darajada qisqartiradi, çunki köp işlar avtomatik tarzda bajariladi.
Maşhurlikning ikkinçi sababi — avtomatik hujjatlaş. Siz endpoint'larni yozganingizdan söng, FastAPI ularning asosida Swagger UI va ReDoc interaktiv hujjatlarini özi yaratadi. Bu degani, sizning API'ngiz uçun alohida hujjat yoziş şart emas — dasturçilar brauzer orqali töğridan-töğri sörovlarni sinab körişlari mumkin. Type hints asosidagi validatsiya esa kiruvçi ma'lumotlarni avtomatik tekşiradi va xatolik bölsa, tuşunarli xabarni qaytaradi.
Birinçi API'ni yaratiş
FastAPI bilan işlaşni boşlaş uçun avval kerakli paketlarni örnatamiz. Buning uçun terminalda quyidagi buyruqni bajaring va u FastAPI hamda uni işga tuşiruvçi Uvicorn serverini örnatadi. Keyin oddiy bir faylda dasturning birinçi versiyasini yozamiz.
pip install fastapi uvicorn
# main.py
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
return {"message": "Salom, FastAPI!"}
@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
return {"item_id": item_id, "q": q}
Uşbu kiçik dasturda biz ikkita endpoint yaratdik. Birinçisi asosiy manzilga (/) GET sörov kelganda oddiy xabar qaytaradi, ikkinçisi esa item_id nomli yöl parametri va q nomli ixtiyoriy sörov parametrini qabul qiladi. E'tibor bering, item_id ga int tipi belgilangan — bu FastAPI'ga avtomatik ravişda kiruvçi qiymatni butun songa aylantiriş va notöğri ma'lumot kelganda xatolik qaytariş körsatmasini beradi. Dasturni işga tuşiriş uçun terminalda uvicorn main:app --reload buyruğini bajaring.
Pydantic modellari bilan validatsiya
FastAPI'ning eng kuçli tomonlaridan biri — Pydantic modellari yordamida murakkab ma'lumotlar tuzilmalarini tasvirlaş va tekşiriş imkoniyatidir. Siz oddiy Python sinfi sifatida model yaratasiz va har bir maydonning tipini körsatasiz, FastAPI esa kiruvçi JSON ma'lumotlarini avtomatik ravişda uşbu modelga moslaştiradi. Agar ma'lumot mos kelmasa, framework batafsil xatolik xabarini qaytaradi.
from pydantic import BaseModel
from fastapi import FastAPI
app = FastAPI()
class User(BaseModel):
name: str
email: str
age: int | None = None
@app.post("/users/")
def create_user(user: User):
return {"created": user.name, "email": user.email}
Uşbu misolda User modeli uç maydondan iborat: name va email majburiy, age esa ixtiyoriy. POST sörovi kelganda FastAPI JSON tanasini avtomatik ravişda User obyektiga aylantiradi va barça maydonlarni tekşiradi. Bu yondaşuv kodni ança xavfsiz va öqişga oson qiladi, çunki ma'lumotlar har doim kutilgan formatda bölişini kafolatlaydi.
Async va avtomatik OpenAPI hujjat
FastAPI töliq async qöllab-quvvatlaşga ega, ya'ni siz endpoint funksiyalarini async def bilan yozib, ma'lumotlar bazasi yoki taşqi API'larga sörovlarni bloklamasdan bajarişingiz mumkin. Bu ayniqsa köp sörovlarni bir vaqtda qayta işlaydigan yuqori yuklamali tizimlar uçun juda muhim, çunki server resurslari samarali işlatiladi. Async funksiya içida await kalit sözi orqali boşqa asinxron operatsiyalarni kutib turişingiz mumkin.
Avtomatik OpenAPI hujjat esa loyihangizni işga tuşirganingizdan söng /docs manzilida Swagger UI körinişida oçiladi. Bu yerda barça endpoint'lar, ularning parametrlari va kutiladigan javoblar körsatilgan böladi. /redoc manzilida esa ReDoc formatidagi muqobil hujjat mavjud. Uşbu xususiyat jamoaviy işda va API'ni boşqa dasturçilarga taqdim etişda bebaho yordam beradi.
Flask va Django bilan farqi hamda qaçon tanlaş kerak
Flask juda yengil va moslaşuvçan, biroq u sinxron işlaydi va validatsiya hamda hujjatlaş uçun qöşimça kutubxonalar talab qiladi. Django esa töliq imkoniyatli framework bölib, admin panel va ORM kabi köplab tayyor komponentlar bilan keladi, lekin u sof API loyihalar uçun biroz oğir bölişi mumkin. FastAPI esa şu ikki dunyo örtasidagi muvozanatni topadi: u yengil, ammo zamonaviy validatsiya va avtomatik hujjatlaşni öz içiga oladi.
FastAPI'ni tanlaş mantiqiy bölgan holatlar — bu yuqori unumdorlik talab qilinadigan API'lar, mikroservis arxitekturasi, maşina örganiş modellarini xizmat sifatida taqdim etiş va real vaqtli ilovalar. Agar sizga töliq veb-sayt, admin panel va şablon tizimi kerak bölsa, Django hali ham yaxşi tanlov bölişi mumkin. Ammo zamonaviy, tez va hujjatlaştirilgan API quriş maqsadingiz bölsa, FastAPI deyarli raqobatsiz yetakçi hisoblanadi. Uni örganiş oson va u sizning mahsulotingizni tez bozorga çiqarişga yordam beradi.