ਪਾਥ ਅਤੇ ਕਿਊਰੀ ਪੈਰਾਮੀਟਰਸ ਕਿਵੇਂ ਕੰਮ ਕਰਦੇ ਹਨ?

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 ਤੋਂ ਸਟ੍ਰਿੰਗ ਨੂੰ ਸਵੈਚਲਿਤ ਤਰੀਕੇ ਨਾਲ ਪਰਿਵਰਤਨ ਕਰਦਾ ਹੈ ਅਤੇ ਜੇ ਇਹ ਮੇਲ ਨਹੀਂ ਖਾਂਦਾ ਤਾਂ ਸਪਸ਼ਟ 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` ਇੱਕ nullable ਵਿਕਲਪਿਕ ਕਿਊਰੀ ਪੈਰਾਮੀਟਰ ਬਣਾਉਂਦਾ ਹੈ। ਡਿਫਾਲਟ ਦੇ ਬਿਨਾਂ, ਉਹ ਜ਼ਰੂਰੀ ਹਨ।

## ਜ਼ਰੂਰੀ ਬਨਾਮ ਵਿਕਲਪਿਕ

```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 ਰੂਟ ਲਈ ਬੁਨਿਆਦੀ (ID ਦ੍ਵਾਰਾ ਇੱਕ ਸਰੋਤ ਪ੍ਰਾਪਤ ਕਰਨਾ, ਫਿਲਟਰਿੰਗ, ਪੰਨਾ ਸੰਖਿਆ, ਖੋਜ)।

FastAPI ਦਾ ਪਹੁੰਚ ਸੁੰਦਰ ਹੈ ਅਤੇ ਇਹ ਉਤਪਾਦਕ ਹੋਣ ਦਾ ਇੱਕ ਮੁੱਖ ਕਾਰਣ ਹੈ: ਸਧਾਰਨ ਟਾਈਪ ਕੀਤੇ ਹੋਏ ਫੰਕਸ਼ਨ ਪੈਰਾਮੀਟਰਸ ਘੋਸ਼ਣਾ ਕਰਕੇ ਤੁਹਾਨੂੰ ਸਵੈਚਲਿਤ ਨਿਕਾਸੀ, **type ਪਰਿਵਰਤਨ**, **ਪ੍ਰਮਾਣਿਕਤਾ** (ਖਰਾਬ ਇਨਪੁਟ 'ਤੇ ਸਪਸ਼ਟ 422 ਗਲਤੀਆਂ ਦੇ ਨਾਲ), ਅਤੇ ਜ਼ਰੂਰੀ-ਬਨਾਮ-ਵਿਕਲਪਿਕ ਭਾਸ਼ਾਵਾਂ (ਡਿਫਾਲਟਸ ਦੇ ਮਾধਿਅਮ ਨਾਲ) ਮਿਲਦਾ ਹੈ — ਸਭ ਮਾਨਕ Python type hints ਤੋਂ ਲਿਆ ਗਿਆ, ਮੈਨੂਅਲ ਪਾਰਸਿੰਗ ਦੇ ਬਿਨਾਂ।

ਫਰਕ (ਪਾਥ ਪੈਰਾਮੀਟਰਸ `{placeholders}` ਤੋਂ ਆਉਂਦੇ ਹਨ, ਬਾਕੀ ਸਭ ਕਿਊਰੀ ਪੈਰਾਮੀਟਰ ਹਨ) ਅਤੇ ਡਿਫਾਲਟਸ ਕਿਸ ਤਰਾਂ ਵਿਕਲਪਤਾ ਨੂੰ ਨਿਯੰਤਰਿਤ ਕਰਦੇ ਹਨ ਇਹ ਸਮਝ ਕੇ FastAPI endpoints ਨਿਰਮਾਣ ਕਰਨ ਲਈ ਰੋਜ਼ਮਰ੍ਹਾ ਦਾ ਜ਼ਰੂਰੀ ਗਿਆਨ ਹੈ।