内部和外部 API 的单独文档 (drf_yasg)

Question

我有两组 API：内部 API，用于我们团队开发的客户端应用程序；外部 API，供我们的业务合作伙伴使用。我想要一个单一的文档页面，通过身份验证，向我们的开发人员显示内部 API，并向所有其他查看者显示外部 API。我怎样才能做到这一点？

我使用：Django、DRF 和 drf-yasg。

PS：我知道这个问题很笼统，但我不知道从哪里开始。我只是猜测需要 get_schema_view、我的视图和 URL 模式中的一些设置。

Answer 1

可以urlconf在get_schema_view(...)函数中设置参数

from django.urls import path
from rest_framework import permissions
from drf_yasg.views import get_schema_view
from drf_yasg import openapi

schema_view_internal = get_schema_view(
    openapi.Info(
        title="Snippets API",
        default_version='v1',
        description="Test description",
    ),
    public=True,
    permission_classes=(permissions.AllowAny,),
    urlconf="path.to.your.internal_app.urls",
)
schema_view_public = get_schema_view(
    openapi.Info(
        title="Snippets API",
        default_version='v1',
        description="Test description",
    ),
    public=True,
    permission_classes=(permissions.AllowAny,),
    urlconf="path.to.your.public_app.urls",
)

urlpatterns = [
    path(
        'public/swagger/',
        schema_view_public.with_ui('swagger', cache_timeout=0),
        name='schema-swagger-ui-internal'
    ),
    path(
        'internal/swagger/',
        schema_view_internal.with_ui('swagger', cache_timeout=0),
        name='schema-swagger-ui-internal'
    ),
]

或者，您也可以设置参数，该参数接受URL 模式patterns列表