Méthodes autorisées

Fait partie de la section API JSON du Journey Django de Coddy. Leçon 8 sur 19.

Envoyez DELETE /api/tasks/ et l’exécution passe au code qui liste les tâches : 200, comme si la requête avait abouti. Un programme qui a demandé la suppression de quelque chose croit alors que c’est fait.

La réponse honnête est 405 Method Not Allowed. Les décorateurs de django.views.decorators.http renvoient ce code avant l’exécution de votre vue, avec un en-tête Allow qui répertorie les méthodes acceptées par la vue :

@require_POST
def subscribe(request):
    ...


@require_http_methods(["GET", "PUT"])
def profile(request):
    ...

require_GET et require_POST sont les formes abrégées pour une seule méthode. Une vue peut avoir deux décorateurs, un par ligne, comme @csrf_exempt au-dessus de @require_POST. Autorisez exactement les méthodes pour lesquelles le code d’une vue effectue une action.

Défi

Facile

Renvoyez le code 405 pour les méthodes qu’une vue ne gère pas :

task_list accepte GET et POST.
stats et task_detail acceptent uniquement GET.

Cliquez sur Run, puis dans l’onglet Shell : from django.test import Client; print(Client().delete("/api/stats/").status_code) affiche 405.

Essayez vous-même

import json

from django.http import JsonResponse
from django.shortcuts import render
from django.views.decorators.csrf import csrf_exempt

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)


@csrf_exempt
def task_list(request):
    if request.method == "POST":
        try:
            data = json.loads(request.body)
        except json.JSONDecodeError:
            return JsonResponse({"error": "The body is not valid JSON."}, status=400)
        errors = {}
        title = data.get("title", "").strip()
        if not title:
            errors["title"] = "This field is required."
        if errors:
            return JsonResponse({"errors": errors}, status=400)
        task = Task.objects.create(
            title=title,
            priority=data.get("priority", "normal"),
        )
        return JsonResponse(task_to_dict(task), status=201)
    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))