مهمة واحدة حسب المعرّف

جزء من قسم واجهات API بصيغة JSON في رحلة Django على Coddy. الدرس 3 من 19.

يريد برنامج قرأ القائمة الآن مهمة واحدة على عنوان URL خاص بها: /api/tasks/1/. يأخذ المسار المعرّف باستخدام <int:pk>، كما فعلت صفحات التفاصيل، ويحوّل المساعد task_to_dict(task) في الشيفرة الابتدائية المهمة إلى قاموس.

الجزء الجديد هو المهمة غير الموجودة. يجيب get_object_or_404 بصفحة 404 بتنسيق HTML من Django، ولا يستطيع برنامج قراءتها. وتجيب واجهة API عن الأخطاء بتنسيق JSON أيضًا، مع رمز الحالة المناسب، وهو الرقم الذي يبيّن نتيجة الطلب: 200 OK، و403 Forbidden، و404 Not Found. يأخذ JsonResponse هذا الرمز عبر status:

return JsonResponse({"error": "Staff only"}, status=403)

للاختيار بين الخطأ والمهمة، ابحث عن الصف من دون إثارة استثناء: تعيد filter(pk=...).first() الصف، أو None عند عدم وجوده.

التحدي

سهل

أضف نقطة نهاية لمهمة واحدة:

عرض task_detail(request, pk) يعيد task_to_dict(task) بتنسيق JSON.
عند عدم وجود المعرّف، أعد {"error": "Task not found"} مع الحالة 404.
المسار "api/tasks/<int:pk>/"، واسمه task_detail.

اضغط على تشغيل، ثم افتح /api/tasks/1/ و/api/tasks/99/.

جرّب بنفسك

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.values("id", "title", "done", "priority")
    return JsonResponse(list(tasks), safe=False)