Django REST Framework cho bạn hai cách viết endpoint: hàm với decorator @api_view và class với APIView. Cả hai đều có request.data, Response chuẩn và mã trạng thái rõ ràng — điểm khác nhau nằm ở cách tổ chức code. Dùng @api_view khi endpoint chỉ làm một việc đơn giản; dùng APIView khi một URL phải xử lý nhiều method HTTP hoặc cần dùng chung logic giữa các method. Chọn đúng ngay từ đầu để khỏi viết lại view khi API lớn dần.
Vấn đề
Nhiều người bắt đầu viết API bằng view Django thuần: tự đọc request.body, tự gọi json.loads, tự bắt lỗi JSON sai rồi trả JsonResponse. Cách này chạy được, nhưng mọi endpoint đều lặp lại cùng một đoạn parse và xử lý lỗi. Dữ liệu đầu vào cũng không được validate tự động — client gửi thiếu trường hay sai kiểu, bạn phải tự kiểm tra tay từng trường và tự quyết mã lỗi trả về. Khi một URL cần thêm POST, PUT hay DELETE, hàm view phình ra thành chuỗi if request.method dài ngoằng, khó đọc và khó test từng nhánh riêng.
import jsonfrom django.http import JsonResponsefrom .models import Postdef post_list(request): if request.method == "GET": posts = list(Post.objects.values("id", "title", "content")) return JsonResponse(posts, safe=False) try: data = json.loads(request.body) except json.JSONDecodeError: return JsonResponse({"error": "JSON không hợp lệ"}, status=400) if "title" not in data: return JsonResponse({"error": "Thiếu trường title"}, status=400) post = Post.objects.create(title=data["title"], content=data.get("content", "")) return JsonResponse({"id": post.id, "title": post.title}, status=201)
Giải pháp
Với @api_view, bạn chỉ cần khai báo method cho phép rồi viết logic chính. DRF tự parse body thành request.data — JSON, form hay multipart đều đọc chung một cách — và serializer lo việc validate. Dữ liệu sai thì is_valid(raise_exception=True) tự trả lỗi 400 đúng chuẩn.
from rest_framework.decorators import api_viewfrom rest_framework.response import Responsefrom rest_framework import statusfrom .models import Postfrom .serializers import PostSerializer@api_view(["GET", "POST"])def post_list(request): if request.method == "GET": posts = Post.objects.all() return Response(PostSerializer(posts, many=True).data) serializer = PostSerializer(data=request.data) serializer.is_valid(raise_exception=True) serializer.save() return Response(serializer.data, status=status.HTTP_201_CREATED)
Khi một URL xử lý nhiều method, @api_view lộ điểm yếu: hàm dài ra vì rẽ nhánh theo request.method, và logic dùng chung — như lấy bản ghi theo pk — không có chỗ gọn để đặt. Lúc này chuyển sang APIView: mỗi method HTTP là một method riêng trong class, logic dùng chung đặt vào method phụ như get_object() để mọi method dùng lại. URL khai báo bằng PostDetail.as_view(), giống hệt view class-based quen thuộc của Django.
from rest_framework.views import APIViewfrom rest_framework.response import Responsefrom rest_framework import statusfrom django.shortcuts import get_object_or_404from .models import Postfrom .serializers import PostSerializerclass PostDetail(APIView): def get_object(self, pk): return get_object_or_404(Post, pk=pk) def get(self, request, pk): post = self.get_object(pk) return Response(PostSerializer(post).data) def put(self, request, pk): post = self.get_object(pk) serializer = PostSerializer(post, data=request.data) serializer.is_valid(raise_exception=True) serializer.save() return Response(serializer.data) def delete(self, request, pk): self.get_object(pk).delete() return Response(status=status.HTTP_204_NO_CONTENT)
Cả hai cách gắn permission như nhau: @api_view dùng decorator @permission_classes, APIView gán thuộc tính permission_classes. Endpoint cần CRUD đầy đủ với router tự sinh URL thì nên lên ViewSet — APIView dành cho endpoint lẻ, không theo khuôn CRUD.
Áp dụng vào dự án của bạn
Rà soát các view API đang viết bằng hàm Django thuần và chuyển chúng sang @api_view trước — thay đổi nhỏ, lợi ích thấy ngay ở khâu validate và mã trạng thái. Với những URL đã có từ hai method trở lên, hoặc có logic lấy bản ghi lặp lại, tách thành APIView với một method get_object() dùng chung. Giữ quy tắc một dòng: một method thì dùng hàm, nhiều method thì dùng class.
Bài viết liên quan
- Django REST Framework: viết Serializer đúng cách — ModelSerializer, depth và SerializerMethodField
- Django REST Framework: loại bỏ N+1 query trong ViewSet bằng select_related và prefetch_related
- Django REST Framework: phân quyền và chống spam API bằng Permission + Throttling trong 5 phút
Câu hỏi thường gặp
@api_view có gắn permission và throttle được không?
Có. Dùng decorator @permission_classes và @throttle_classes trên hàm, tương đương thuộc tính cùng tên trong APIView. Cách khai báo khác nhau, hiệu lực như nhau.
APIView khác gì ViewSet?
ViewSet gom đủ bộ CRUD của một tài nguyên kèm router tự sinh URL. APIView tự do hơn: bạn tự định nghĩa từng method và khai báo URL. Endpoint lẻ, không theo khuôn CRUD thì APIView gọn hơn; tài nguyên chuẩn CRUD thì ViewSet nhanh hơn.
request.data khác gì request.POST?
request.POST chỉ chứa dữ liệu form. request.data của DRF parse mọi định dạng — JSON, form, multipart — nên bạn đọc dữ liệu đầu vào bằng một cách duy nhất, bất kể client gửi kiểu nào.
Quên trả status=201 khi tạo mới thì sao?
Mặc định Response trả 200, client không phân biệt được “tạo mới thành công” với “trả dữ liệu thường”. Luôn trả status.HTTP_201_CREATED cho POST tạo mới và 204 cho DELETE thành công — quy ước REST mà client và tài liệu API đều trông đợi.
@api_view có nhận nhiều method không?
Có, khai báo @api_view([“GET”, “POST”]) rồi rẽ nhánh theo request.method. Nhưng từ hai method trở lên, khi logic bắt đầu lặp lại, APIView với các method riêng sẽ gọn và dễ test hơn.
💬 Bạn đã thử cách này trong dự án của mình chưa? Nếu gặp lỗi hoặc có cách làm gọn hơn, để lại bình luận bên dưới — mình đọc hết và sẽ bổ sung những ý hay vào bài.
