יצירה באמצעות POST

חלק מהיחידה ממשקי API של JSON במסלול ה-Django של Coddy. שיעור 5 מתוך 19.

תוכניות יכולות לקרוא את המשימות שלך, אך לא להוסיף משימה. כדי ליצור משימה, תוכנית שולחת בקשת POST לכתובת ה-URL של הרשימה, כשהמשימה מצורפת כ-JSON ב-body של הבקשה, כלומר בנתונים שנשלחים יחד איתה. טופס ממלא את request.POST; JSON לא. קרא את גוף הבקשה הגולמי, request.body, והפוך אותו ל-Python באמצעות json.loads.

כתובת URL אחת יכולה לבצע שתי משימות, בהתאם ל-request.method. התצוגה הזאת רק מחזירה את מה שנשלח אליה:

def echo(request):
    if request.method == "POST":
        data = json.loads(request.body)
        return JsonResponse({"you_sent": data})
    return JsonResponse({"hint": "Send me a POST"})

תצוגה שיוצרת משהו משיבה 201 נוצר יחד עם האובייקט החדש, כדי שהתוכנית תוכל לקבל את ה-id שלו. מפתח שהתוכנית יכולה להשמיט נקרא עם ערך ברירת מחדל: data.get("colour", "black").

אתגר

בינוני

אפשר ליצור משימות באמצעות POST /api/tasks/:

קראו את גוף ה-JSON, למשל {"title": "Pay rent", "priority": "high"}, וצרו את המשימה. אם לא מציינים priority, הערך שלה יהיה "normal".
החזירו את המשימה החדשה ואת הסטטוס 201.
GET ממשיך להציג ולסנן את הרשימה.

שורת הכתובת שולחת בקשות GET בלבד. לחצו על Run, ואז הקלידו את זה בלשונית Shell: from django.test import Client; print(Client().post("/api/tasks/", {"title": "Pay rent"}, content_type="application/json").json())

נסו בעצמכם

from django.http import JsonResponse
from django.shortcuts import render

from .models import Task


def task_to_dict(task):
    return {
        "id": task.id,
        "title": task.title,
        "done": task.done,
        "priority": task.priority,
    }


def home(request):
    return render(request, "tasks/home.html", {"tasks": Task.objects.all()})


def stats(request):
    data = {
        "total": Task.objects.count(),
        "done": Task.objects.filter(done=True).count(),
    }
    return JsonResponse(data)


def task_list(request):
    tasks = Task.objects.all()
    done = request.GET.get("done")
    if done == "true":
        tasks = tasks.filter(done=True)
    elif done == "false":
        tasks = tasks.filter(done=False)
    return JsonResponse([task_to_dict(task) for task in tasks], safe=False)


def task_detail(request, pk):
    task = Task.objects.filter(pk=pk).first()
    if task is None:
        return JsonResponse({"error": "Task not found"}, status=404)
    return JsonResponse(task_to_dict(task))