بتل کد Battle Codeدارد باز می‌شود…

مثال تابع (بک‌اند با پایتون): def add_book():

مثال 5 از درس جلسه‌ی 29 آموزش بک‌اند و ساخت API با پایتون برای نوجوانان: نقشه‌ی API: قبل از کد

✅ هر حالت، کد خودش. وقتی نقشه کد وضعیت هر حالت را گفته، کد فقط آن را پیاده می‌کند: هر جا حالت بد است، abort(...) با همان کد و یک پیام روشن. همه‌ی خطاها هم یک شکل دارند، {"error": "..."}، تا اپ همیشه بداند پیام خطا کجاست (جلسه‌ی ۱۰). ترتیب بررسی‌ها هم مهم است: اول «عنوان دارد؟» (400)، بعد «تکراری است؟» (409)، آخر ساختن (201).

from server import app, ask, request, abort

books = [{"id": 1, "title": "Wonder"}, {"id": 2, "title": "Matilda"}]

@app.post("/api/v1/books")
def add_book():
    data = request.json or {}
    title = data.get("title")
    if not title:
        abort(400, "title is required")
    for b in books:
        if b["title"] == title:
            abort(409, "this book is already here")
    book = {"id": len(books) + 1, "title": title}
    books.append(book)
    return book, 201

ask("POST /api/v1/books", {"title": "Coraline"})
ask("POST /api/v1/books", {"title": "Wonder"})
ask("POST /api/v1/books", {})

این کد را همین‌جا در ویرایشگر پایتون اجرا کن، عددها و متن‌هایش را عوض کن و دوباره اجرا کن تا ببینی چه تغییری می‌کند.

بیشتر بخوان: تابع در پایتون: آموزش def، پارامتر و return با مثال

← مثال قبلی · برگشت به درس جلسه‌ی 29: نقشه‌ی API: قبل از کد · مثال بعدی → · چالش‌های این جلسه