مثال تابع (بکاند با پایتون): def all_books():
مثال 5 از درس جلسهی 10 آموزش بکاند و ساخت API با پایتون برای نوجوانان: طراحی یک API خوب
فهرستها در پاکت. بهجای یک لیست خالی و تنها، فهرست را در یک دیکشنری بگذار: {"count": 2, "items": [...]}. سه دلیل: مشتری بدون شمردن میداند چند تا آمده؛ «هیچی» هم روشن است ({"count": 0, "items": []})؛ و بعدها میشود چیزهای تازه کنارش گذاشت (مثل "page": 2) بیآنکه برنامهی مشتریها خراب شود. یک لیست تنها جایی برای این چیزها ندارد.
from server import app, ask, request
books = [
{"id": 1, "title": "The Hobbit", "genre": "fantasy"},
{"id": 2, "title": "Wonder", "genre": "story"},
{"id": 3, "title": "Coraline", "genre": "fantasy"},
]
@app.get("/books")
def all_books():
genre = request.args.get("genre")
items = []
for book in books:
if not genre or book["genre"] == genre:
items.append(book)
return {"count": len(items), "items": items}
ask("GET /books?genre=fantasy")
ask("GET /books?genre=poetry")
این کد را همینجا در ویرایشگر پایتون اجرا کن، عددها و متنهایش را عوض کن و دوباره اجرا کن تا ببینی چه تغییری میکند.
بیشتر بخوان: تابع در پایتون: آموزش def، پارامتر و return با مثال
← مثال قبلی · برگشت به درس جلسهی 10: طراحی یک API خوب · مثال بعدی → · چالشهای این جلسه