पाथ र क्वेरी प्यारामिटरहरू कसरी काम गर्छन्?

Question

Accepted Answer

FastAPI ले फंक्शन आर्गुमेन्टहरूबाट **पाथ प्यारामिटरहरू** (URL पाथको भाग) र **क्वेरी प्यारामिटरहरू** (` ?`को पछाडि) निकाल्छ, type hints प्रयोग गरेर तिनलाई स्वचालित रूपमा रूपान्तरण र प्रमाणित गर्छ।

## पाथ प्यारामिटरहरू — 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}` सँग मेल खान्छ **पाथ प्यारामिटर** बन्छ। type hint (`int`) ले URL बाट string लाई स्वचालित रूपमा रूपान्तरण गर्छ र यदि यो मेल खाँदैन भने स्पष्ट ४२२ त्रुटि फर्काउँछ।

## क्वेरी प्यारामिटरहरू — बाकी सबै कुरा

```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
```

## यो महत्त्वपूर्ण क्यों छ

पाथ र क्वेरी प्यारामिटरहरू यसरी endpoints ले URL बाट इनपुट प्राप्त गर्छन् — लगभग हरेक API मार्गमा अनिवार्य (आइडी द्वारा संसाधन प्राप्त गरिरहेको छ, फिल्टरिङ, पेजिनेशन, खोज गरिरहेको छ)।

FastAPI को दृष्टिकोण सुन्दर छ र यो उत्पादनशील हुनुको मुख्य कारण हो: typed फंक्शन प्यारामिटरहरू घोषणा गर्नुले तपाईलाई स्वचालित निष्कर्षण, **type रूपान्तरण**, **प्रमाणीकरण** (खराब इनपुटमा स्पष्ट ४२२ त्रुटिहरूसहित), र आवश्यक-बनाम-वैकल्पिक शब्दार्थ (डिफल्टहरूको माध्यमबाट) — सबै मानक Python type hints बाट निकालिएको, कुनै म्यानुअल पार्सिङ बिना।

भेद (पाथ प्यारामिटरहरू `{placeholders}`बाट आउँछन्, बाकी सबै क्वेरी प्यारामिटर हो) र डिफल्टहरूले कसरी वैकल्पिकता नियन्त्रण गर्छन् भनेर बुझ्न FastAPI endpoints निर्माण गर्दा हरेक दिनको आवश्यक ज्ञान हो।