টাইপ চেকিংয়ের বাইরে, FastAPI আপনাকে Query, Path, এবং Field ব্যবহার করে পাথ/কোয়েরি প্যারামিটার এবং মডেল ফিল্ডে সীমাবদ্ধতা যোগ করতে দেয় — দৈর্ঘ্য, পরিসীমা এবং প্যাটার্নের মতো নিয়ম প্রয়োগ করে, লঙ্ঘনের সময় স্বয়ংক্রিয় 422 ত্রুটি এবং ডকুমেন্টেশন সহ।
from fastapi import Query, Path
@app.get("/items")
def search(
q: str = Query(min_length=3, max_length=50), # string length bounds
page: int = Query(default=1, ge=1), # >= 1
limit: int = Query(default=10, ge=1, le=100), # 1 <= limit <= 100
code: str = Query(pattern=r"^[A-Z]{3}$"), # regex pattern
):
...
@app.get("/items/{item_id}")
def get(item_id: int = Path(ge=1)): # path param must be >= 1
...
Query() এবং Path() কোয়েরি এবং পাথ প্যারামিটারগুলিতে সীমাবদ্ধতা যোগ করে। সাধারণ সীমাবদ্ধতা: min_length/max_length (স্ট্রিং), ge/gt/le/lt (সংখ্যা), pattern (regex)। লঙ্ঘনগুলি স্বয়ংক্রিয়ভাবে একটি স্পষ্ট 422 ত্রুটি তৈরি করে।
from pydantic import BaseModel, Field, EmailStr
class User(BaseModel):
name: str = Field(min_length=1, max_length=100)
age: int = Field(ge=0, le=120)
email: EmailStr # format validation via a type
bio: str = Field(default="", max_length=500, description="User bio")
অনুরোধ বডি বৈধ করতে Field() এর মাধ্যমে মডেল ফিল্ডগুলিতে একই সীমাবদ্ধতা প্রযোজ্য। বিশেষায়িত প্রকার (EmailStr, HttpUrl, UUID) বিন্যাস যাচাই করে।
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
আপনি যে প্রতিটি সীমাবদ্ধতা ঘোষণা করেন তা OpenAPI ডকুমেন্টেশনেও প্রতিফলিত হয়, তাই ভোক্তারা নিয়মগুলি দেখতে পান।
বৈধতা সীমাবদ্ধতা যোগ করা নিরাপত্তা/শক্তিশালীতা এবং ভাল API ডিজাইন উভয়ের জন্য গুরুত্বপূর্ণ — নিয়ম ঘোষণা করা (দৈর্ঘ্য সীমা, সংখ্যাগত পরিসীমা, regex প্যাটার্ন, ফরম্যাট প্রকার) নিশ্চিত করে যে বিকৃত বা দূষিত ইনপুট স্পষ্ট ত্রুটির সাথে আপনার লজিকে পৌঁছানোর আগে প্রত্যাখ্যান করা হয়, যা অপরিহার্য কারণ আপনাকে কখনও কাঁচা ইনপুটকে বিশ্বাস করতে হবে না।
FastAPI এটিকে ঘোষণামূলক এবং সহজ করে তোলে: Query/Path/Field সীমাবদ্ধতা স্বয়ংক্রিয়ভাবে যাচাই করা হয় (কাঠামোগত 422 ত্রুটি তৈরি করে) এবং একই সাথে API ডক্সে ডকুমেন্ট করা হয়, তাই নিয়মগুলি একটি একক ঘোষণা থেকে প্রয়োগ এবং যোগাযোগ করা হয়।
সাধারণ সীমাবদ্ধতা এবং বিশেষায়িত বৈধতা প্রকার জানা নিরাপদ, সুসংজ্ঞায়িত endpoint তৈরির প্রতিদিনের জ্ঞান — এটি কীভাবে আপনি মৌলিক টাইপ চেকিংকে অতিক্রম করে আপনার ডেটা অবশ্যই সন্তুষ্ট করা আবশ্যক সেই বাস্তব ব্যবসায়িক নিয়মগুলি প্রয়োগ করেন।