1
DRFドキュメントをinclude_docs_urls
に設定すると、HTMLページはプロジェクトのurls.py
に明示されたモジュールのみをレンダリングします。 しかし、すべてのモジュールはurlpatterns
に追加され、django.conf.urls.include
の機能を持つHTMLレンダラは無視します。しかし、coreapi-cliは正しいスキーマを得ます。DRFドキュメントモジュールは正しいシェーマを取得しますが、HTMLレンダラーでは失敗します
コードがある場合:
api_patterns = [
url(r'^api-token-refresh/$', refresh_jwt_token),
url(r'^api-token-verify/$', verify_jwt_token),
]
urlpatterns = [
url(r'^$', HTMLReport.as_view()),
url(r'^admin/', admin.site.urls),
url(r'^vending/', include('vending.urls')),
url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework')),
url(r'^api-token-auth/$', obtain_jwt_token),
url(r'^api-tools/$', include(api_patterns)),
url(r'^docs/', include_docs_urls(title='TMS API', description='Terminal Management System API', public=True))
]
HTMLはvending.urls
、およびapi_patterns
のためのドキュメントを無視します。コードがある場合
しかし:
urlpatterns = [
url(r'^$', HTMLReport.as_view()),
url(r'^admin/', admin.site.urls),
url(r'^vending/', include('vending.urls')),
url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework')),
url(r'^api-token-auth/$', obtain_jwt_token),
url(r'^api-token-refresh/$', refresh_jwt_token),
url(r'^api-token-verify/$', verify_jwt_token),
url(r'^docs/', include_docs_urls(title='TMS API', description='Terminal Management System API', public=True))
]
のみ
vending.urls
無視されます。