【后端】【django】Django DRF `@action` 详解：自界说 ViewSet 方法 ...

Django DRF @action 详解：自界说 ViewSet 方法

在 Django REST Framework（DRF）中，@action 装饰器用于为 ViewSet 添加自界说的 API 端点。相比于 update、create 等默认方法，@action 允许我们界说 更加清晰、语义化 的 API 访问路径，使接口更加易读且符合 RESTful 计划原则。

---

1. @action 的作用

@action 主要用于 自界说 API 端点，制止滥用 update、create 等标准方法，使 API 语义更加清晰。例如：

• POST /users/{id}/assign_roles/ ✅ （自界说用户角色分配接口，语义清晰）
  
• POST /users/{id}/change_password/ ✅ （单独的修改暗码接口）
  
• GET /users/{id}/permissions/ ✅ （查询用户权限）
  

---

2. @action 的基本用法