Sida Loo Isticmaalo FastAPI Si Loogu Dhiso Adeegyo API Oo Sareeya

FastAPI waa qaab-dhismeed Web casri ah, oo degdeg ah (waxtar leh), oo loogu talagalay in lagu dhiso API. Waxay ku saleysan tahay tilmaamaha noocyada Python, waxayna taageertaa barnaamijyada aan tooska ahayn, taasoo u oggolaaneysa horumariyeyaasha inay dhisaan adeegyo API oo sareeya, oo leh helitaan sare iyo dib u dhac hoose. Qoraalkan wuxuu si faahfaahsan u sharxayaa sida loo isticmaalo FastAPI si loo dhiso adeegyo API oo sareeya, waxaanan u kala qaybin doonaa talaabooyin si aan kaaga caawino inaad gaarto dhammaan habka laga bilaabo dhismaha deegaanka ilaa daabacaadda.

Talaabada Koowaad: Diyaarinta Deegaanka

Waxaad u baahan tahay inaad hubiso in deegaankaaga horumarinta uu ku rakiban yahay Python 3.6+. Haddii aanad weli rakibin, waxaad booqan kartaa Bogga Rasmiga ah ee Python si aad u soo dejiso oo u rakibto.

Rakibida FastAPI iyo Uvicorn

FastAPI lafteeda ma bixiso adeeg, waxay u baahan tahay server ASGI si ay u qaadato. Halkan waxaanu isticmaaleynaa Uvicorn, oo ah server ASGI oo waxtar leh. Waxaad isticmaali kartaa amarka soo socda si aad u rakibto FastAPI iyo Uvicorn:

pip install fastapi uvicorn

Talaabada Labaad: Dhisida API Aasaasi

Aan abuurno codsi FastAPI fudud.

Abuuritaanka Faylka Codsiga

Dhexda galkaaga mashruuca, abuur fayl Python ah, sida main.py, ka dibna ku qor koodhka soo socda:

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def read_root():
    return {"message": "Hello, World!"}

Koodhkan kor ku xusan, waxaan marka hore ku daray FastAPI oo aan abuurnay nuqul app. Kadib, waxaan qeexnay waddo GET ah, oo marka la galo dariiqa asaasiga ah / ay soo celinayso jawaab JSON fudud.

Bilowga Serverka

Isticmaal amarka soo socda si aad u bilowdo serverkaaga FastAPI:

uvicorn main:app --reload

• main: waxay tilmaamaysaa magaca faylka, oo aan lahayn .py dhammaadka.
• app: waxay tilmaamaysaa nuqulka FastAPI.
• --reload: habka horumarinta, serverka si otomaatig ah ayuu dib u bilaabmaya marka faylka la beddelo.

Talaabada Saddexaad: Qeexida Waddooyinka iyo Qaab-dhismeedka Xogta

Si aad u dhisto API adag, waxaad u baahan tahay inaad isticmaasho Pydantic si aad u qeexdo qaab-dhismeedka xogta.

Abuuritaanka Qaab-dhismeedka Xogta

Ku dar waxyaabaha soo socda main.py:

from pydantic import BaseModel

class Item(BaseModel):
    name: str
    price: float
    is_available: bool = True

Koodhkan wuxuu isticmaalaa Pydantic si uu u abuuro qaab-dhismeed xogta Item, oo ka kooban sifooyinka magaca alaabta, qiimaha, iyo haddii ay diyaar tahay.

Ku daridda Waddo Cusub

Kadib, waxaan qeexi karnaa waddo cusub oo POST ah si aan u helno xogta nooca Item:

@app.post("/items/")
async def create_item(item: Item):
    return {"item_name": item.name, "item_price": item.price}

Waddadan, FastAPI waxay si otomaatig ah u xaqiijineysaa xogta la keenay waxayna u beddeshaa qaab-dhismeedka Item.

Talaabada Afaraad: Abuurista Dukumiintiyada Si Otomaatig ah

Mid ka mid ah faa'iidooyinka ugu weyn ee FastAPI waa awoodda ay u leedahay in ay si otomaatig ah u abuurto dukumiintiyada API. Waxaad ka eegi kartaa adigoo booqanaya cinwaannadan:

• Swagger UI: http://127.0.0.1:8000/docs
• ReDoc: http://127.0.0.1:8000/redoc

Dukumiintiyada la abuuray, waxaad si isdhexgal ah u tijaabin kartaa API, waxaadna arki kartaa qaababka codsiga iyo jawaabta ee waddo kasta.

Talaabada Shanaad: Ku Darida Aqoonsiga

Codsiyada dhabta ah, aqoonsigu waa marxalad muhiim ah. Aan ku darno aqoonsi fudud oo ku saleysan doorka.

Ku Darida Waxyaabaha Amniga

Isticmaalka habka Depends ee FastAPI iyo OAuth2PasswordBearer si aad u hirgeliso aqoonsiga:

from fastapi import Depends, HTTPException, status
from fastapi.security import OAuth2PasswordBearer

oauth2_scheme = OAuth2PasswordBearer(tokenUrl="token")

async def fake_decode_token(token):
    return {"sub": token}

async def get_current_user(token: str = Depends(oauth2_scheme)):
    user = fake_decode_token(token)
    if user is None:
        raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail="Aqoonsiga aan sax ahayn")
    return user

Ilaalinta Waddooyinka

Kadib, waxaad ku dari kartaa aqoonsiga waddooyinka u baahan in la ilaaliyo:

@app.get("/users/me")
async def read_users_me(current_user: dict = Depends(get_current_user)):
    return current_user

Talaabada Lixaad: Daabacaadda Codsiga FastAPI

Markaad dhammayso horumarinta, waxaa laga yaabaa inaad u baahato inaad codsigaaga ku daabacdo server daruur ah. Waxaad dooran kartaa inaad isticmaasho Docker si aad u daabacdo.

Abuuritaanka Dockerfile

Dhexda galka mashruucaaga, abuur fayl la yiraahdo Dockerfile, ku qor waxyaabaha soo socda:

FROM tiangolo/uvicorn-gunicorn-fastapi:python3.8

COPY ./app /app

Dhisida Sawirka Docker

Dhexda terminal-kaaga, isticmaal amarka soo socda si aad u dhisto sawirka Docker:

docker build -t myfastapiapp .

Socodsiinta Weelka Docker

Socodsiinta codsigaaga FastAPI:

docker run -d --name fastapi -p 80:80 myfastapiapp

Gunaanad

Qoraalkan, waxaan si faahfaahsan u sharxay sida loo isticmaalo FastAPI si loo dhiso adeegyo API oo sareeya, laga bilaabo diyaarinta deegaanka ilaa abuurista API aasaasi ah, qeexida waddooyinka iyo qaab-dhismeedka xogta, ilaa ku darista aqoonsiga iyo daabacaadda. FastAPI waxay bixisaa hawlo badan oo awood leh, taasoo ka dhigaysa dhisidda API-yada casriga ah mid sahlan oo waxtar leh, waxaadna ka sii baari kartaa hawlo iyo astaamo dheeraad ah adigoo isticmaalaya dukumiintiyada rasmiga ah. Waxaan rajeynayaa in qoraalkan uu kaa caawin doono inaad si dhaqso leh u bilowdo FastAPI, si hufan u kordhiso waxtarka horumarinta mashruucaaga!