Django REST Framework: Web API cho Django

Django REST Framework là gì?

Django REST Framework là một bộ công cụ gắn vào một dự án Django có sẵn để thêm lớp REST API — serializer để chuyển instance của model thành JSON và ngược lại, viewset và router để nối các endpoint, cùng các class authentication và permission để bảo vệ chúng. Nó nằm trên Django chứ không thay thế Django, nên ORM, trang admin và cấu trúc app vẫn giữ nguyên; REST framework chỉ thêm vào phần bề mặt API.

Tính năng cốt lõi của Django REST Framework

• ✓Serializer chuyển queryset của Django ORM thành JSON và ngược lại — HyperlinkedModelSerializer và ModelSerializer đọc trực tiếp các field của model từ class Meta.
• ✓ViewSet kết hợp với DefaultRouter tự sinh ra URL cho list, detail, create, update, delete chỉ từ một class được đăng ký, thay vì phải viết từng path() riêng.
• ✓Browsable API hiển thị endpoint dưới dạng trang web tương tác, có cả nút đăng nhập để test các request cần authentication mà không cần client riêng.
• ✓Authentication có sẵn trong framework, cộng thêm các gói tùy chọn cho OAuth1a và OAuth2 khi session hay token auth thông thường chưa đủ.
• ✓Function-based view thuần vẫn dùng được nếu bạn không muốn dùng viewset hay generic view — README nói rõ đây là một lối thoát khi cần.
• ✓Nguồn dữ liệu không phải ORM cũng được hỗ trợ qua class Serializer cơ bản, không chỉ model Django qua ModelSerializer.

Khi nào nên dùng Django REST Framework

• •Thêm JSON API vào một ứng dụng Django đã có sẵn model, mà không cần đổi sang framework khác.
• •Dựng CRUD endpoint nhanh: đăng ký một ModelViewSet với DefaultRouter là có ngay list/detail/create/update/delete.
• •Cần authentication nhiều hơn một scheme token tự chế — session auth có sẵn, còn OAuth1a/OAuth2 chỉ cách một gói tùy chọn.
• •Cho phép frontend hay QA click thử endpoint ngay trên trình duyệt thay vì phải viết curl cho từng lần kiểm tra thủ công.

Cài đặt Django REST Framework

Cài bằng pip: `pip install djangorestframework`. Sau đó thêm `'rest_framework'` vào `INSTALLED_APPS` trong settings của Django — đó là toàn bộ phần cấu hình cần trước khi bạn bắt đầu viết serializer và viewset. README ghi yêu cầu Python 3.10+ và Django 5.2, 6.0 hoặc 6.1, và chỉ chính thức hỗ trợ bản patch mới nhất của mỗi nhánh.

Xây dựng một API đơn giản với DRF

Ví dụ trong chính README là minh hoạ rõ nhất: định nghĩa một class serializer (chẳng hạn HyperlinkedModelSerializer) với class Meta khai báo model và các field cần expose, định nghĩa một ModelViewSet ghép queryset với serializer đó, rồi đăng ký viewset lên một DefaultRouter và include urls của router vào urlpatterns. Chạy `./manage.py runserver` là endpoint đã hoạt động — bạn có thể mở thẳng trên trình duyệt, đăng nhập qua nút đăng nhập, hoặc gọi bằng curl từ command line. Không cần viết tay từng path(), không cần tự encode JSON. Mọi thứ chạy ngay khi các phần đã được nối đúng.

Các lựa chọn thay thế cho Django REST Framework

Câu hỏi thường gặp

Vấn đề mà nó giải quyết

Django cung cấp model và view, nhưng không có sẵn lớp REST: biến một model thành JSON theo cách thông thường nghĩa là phải tự viết tay phần serialization, phân trang và kiểm tra quyền trong từng view. Django REST Framework thay thế phần code lặp lại đó bằng serializer, viewset và router, được gắn vào đúng cơ chế INSTALLED_APPS mà Django đã có sẵn, nên việc thêm một API không có nghĩa là phải dựng thêm một hệ thống song song bên cạnh ứng dụng Django.

Ai nên dùng — và ai nên bỏ qua

Nên thử nếu bạn đã xây dựng trên Django và cần expose model ra JSON — con đường ModelViewSet cộng DefaultRouter dựng được một CRUD API chỉ trong một buổi chiều. Nên bỏ qua nếu bạn không dùng Django: không có chế độ framework-agnostic, nên chọn DRF cho lớp API cũng đồng nghĩa phải chọn Django bên dưới. Cũng nên bỏ qua nếu stack của bạn cũ hơn yêu cầu của README — Python dưới 3.10 hay Django dưới 5.2 đã nằm ngoài các phiên bản được hỗ trợ ngay từ đầu.

Repo liên quan