自己解決できたようなので、投稿します。
drf-nested-routersパッケージを使用します。
この例では、modelsで定義したデータベースとリンクしない形でAPI応答する処理となっています。
このパッケージの要件
Django: (2.2, 3.0, 3.1, 3.2, 4.0)
Python: (3.7, 3.8, 3.9, 3.10, 3.11)
Django REST framework: (3.11, 3.12, 3.13)
フォルダ構成
api:rest framework用アプリケーション
app:WEBサーバー用アプリケーション
config:Djangoプロジェクト
フォルダツリー
.
├── api
│ ├── __init__.py
│ ├── admin.py
│ ├── apps.py
│ ├── migrations
│ │ ├── __init__.py
│ ├── serializers.py
│ ├── templates
│ │ └── api
│ │ └── version.html
│ ├── tests.py
│ ├── urls.py
│ └── views.py
├── app
│ ├── __init__.py
│ ├── admin.py
│ ├── apps.py
│ ├── migrations
│ │ ├── 0001_initial.py
│ │ ├── __init__.py
│ ├── models.py
│ ├── templates
│ │ └── app
│ │ └── index.html
│ ├── test
│ │ ├── test_models.py
│ │ └── test_models_handle.py
│ ├── tests.py
│ ├── urls.py
│ └── views.py
├── config
│ ├── __init__.py
│ ├── asgi.py
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
├── db.sqlite3
└── manage.py
ソースコード
config/urls.pyにおいて、urlパスを各アプリケーションに振り分ける。
urlpatterns = [
path('app/', include('app.urls')),
path('api/', include('api.urls')),
]
api/urls.py
registerで登録する順序が重要です。
from django.urls import path, include
from rest_framework_nested import routers
from .views import *
router = routers.SimpleRouter()
router.register('book/open', BookOpenViewSet, basename='book_open')
router.register('book/close', BookCloseViewSet, basename='book_close')
router.register('book', BookViewSet, basename='book')
book_router = routers.NestedSimpleRouter(router, r'book', lookup='book')
book_router.register(r'open', BookKeyOpenViewSet, basename='book_open')
urlpatterns = [
path('v1/', include(router.urls)),
path('v1/', include(book_router.urls)),
path('version/', VersionView),
]
api/views.py
from django.shortcuts import render
import json
from rest_framework import viewsets
from django.http import JsonResponse
def VersionView(request, *args,**kwargs):
params = {
'version':
json.dumps({'version':'ver 1.2'},indent=2)
}
return render(request,"api/version.html",params)
class BookViewSet(viewsets.ViewSet):
def list(self, requset):
return JsonResponse({"book":"all book list"}, json_dumps_params={'indent': 2})
def retrieve(self, request, pk=None):
return JsonResponse({"book":f"book id = {pk}"}, json_dumps_params={'indent': 2})
def create(self, request):
# POST
return JsonResponse({"book":f"book create"}, json_dumps_params={'indent': 2})
class BookOpenViewSet(viewsets.ViewSet):
def list(self, requset):
return JsonResponse({"book":"book open command"}, json_dumps_params={'indent': 2})
class BookCloseViewSet(viewsets.ViewSet):
def list(self, requset):
return JsonResponse({"book":"book cloase command"}, json_dumps_params={'indent': 2})
class BookKeyOpenViewSet(BookOpenViewSet):
def list(self, request, book_pk=None):
return JsonResponse({"book":f"book({book_pk}) open command"}, json_dumps_params={'indent': 2})
def retrieve(self, request, pk=None, book_pk=None):
return JsonResponse({"book":f"book({book_pk}) open command({pk})"}, json_dumps_params={'indent': 2})
URLパス
注意:
POSTコマンドの末尾/
が必須です。
この理由がお分かりの方はコメントにて追加情報をいただけるとありがたいです。