பாதை மற்றும் வினவல் அளவுருக்கள் எவ்வாறு செயல்படுகின்றன?

Question

Accepted Answer

FastAPI **பாதை அளவுருக்கள்** (URL பாதையின் பகுதி) மற்றும் **வினவல் அளவுருக்கள்** (`` இன் பிறகு) செயல்பாட்டு வாதங்களிலிருந்து பிரித்தெடுக்கிறது, தானியங்கி மாற்றம் மற்றும் சரிபார்ப்புக்கான வகை குறிப்புகளைப் பயன்படுத்துகிறது.

## பாதை அளவுருக்கள் — URL இன் பகுதி

```python
@app.get("/items/{item_id}")        # {item_id} in the path
def get_item(item_id: int):          # matched by NAME; `int` converts & validates
    return {"item_id": item_id}
# GET /items/5 → item_id = 5 (int).  GET /items/abc → 422 error (not an int)
```

பாதையில் `{placeholder}` உடன் பொருந்தும் பெயரைக் கொண்ட ஒரு செயல்பாட்டு அளவுரு ஒரு **பாதை அளவுரு** ஆக மாறும். வகை குறிப்பு (`int`) URL இலிருந்து சரத்தை தானாக மாற்றுகிறது மற்றும் அது பொருந்தாவிட்டால் தெளிவான 422 오류ஐ வழங்குகிறது.

## வினவல் அளவுருக்கள் — மற்றெல்லாம்

```python
@app.get("/items")
def list_items(skip: int = 0, limit: int = 10, q: str | None = None):
    # parameters NOT in the path become QUERY parameters
    # GET /items?skip=20&limit=5&q=phone → skip=20, limit=5, q="phone"
    return {"skip": skip, "limit": limit, "q": q}
```

பாதையில் **இல்லாத** செயல்பாட்டு அளவுருக்கள் **வினவல் அளவுருக்கள்** ஆக மாறும். இயல்புநிலை மதிப்பு அவற்றை விரும்பிய தேர்வாக்குகிறது (`skip: int = 0`); `str | None = None` ஒரு செல்லலாயிற்ற விரும்பிய வினவல் அளவுருவை உண்டாக்குகிறது. இயல்புநிலை இல்லாமல், அவை தேவைப்படுகின்றன.

## தேவைப்படும் வெஸ்ஸஸ் விரும்பிய

```python
def search(q: str):              # REQUIRED query param (no default) → ?q=... must be present
def search(q: str = ""):          # optional, defaults to ""
def search(q: str | None = None): # optional, defaults to None
```

## இரண்டையும் இணைப்பது

```python
@app.get("/users/{user_id}/items")
def user_items(user_id: int, limit: int = 10):
    # user_id = path param, limit = query param — distinguished by the path
```

## இது ஏன் முக்கியமாக இருக்கிறது

பாதை மற்றும் வினவல் அளவுருக்கள் சுயவிவரணச் சமிப்புகள் URL இலிருந்து உள்ளீட்டைப் பெறும் வழி — ஏறக்குறைய ஒவ்வொரு API பாதைக்கும் அடிப்படையான (வளம் ID ஆல் பெறுதல், வடிப்பு, பக்கப்பதிப்பு, தேடல்).

FastAPI இன் அணுகுமுறை நேர்த்தியானது மற்றும் இது ஒரு முக்கிய காரணம்: வெறுமனே தட்டச்சு செய்யப்பட்ட செயல்பாட்டு அளவுருக்களை அறிவிப்பது தানாக பிரித்தெடுப்பு, **வகை மாற்றம்**, **சரிபார்ப்பு** (மோசமான உள்ளீடுகளில் தெளிவான 422 오류 கொண்டு) மற்றும் தேவைப்படும்-வெஸ்ஸஸ்-விரும்பிய சொற்பொருள் (இயல்புநிலை வழியாக) — அனைத்தும் நிலையான Python வகை குறிப்புகளிலிருந்து பெறப்பட்ட, கை மூலம் பாகுபடுத்தல் இல்லாமல்.

பாதை அளவுருக்கள் `{placeholder}` இலிருந்து வரும் என்று வேறுபாடு புரிந்துகொள்ளல் மற்றும் இயல்புநிலை மூல்யமாயிற்றை எவ்வாறு கட்டுப்படுத்துகிறது என்பது FastAPI சமிப்புகளை உண்டாக்குவதற்கான அத்யாவசிய அன்றாட உலகறிவு.