Я только начал использовать swagger для документации по API. Я следил за этими docs, но более половины URL-адресов были исключены из чванства.Проблемы с использованием swagger с Django Rest Framework
Как вы можете видеть на изображении ниже, он отображает некоторые URL-адреса, но несколько URL-адресов исключены, а URL-адреса, отображаемые в swagger, не включают в себя полную функциональность, например, нет части тела для проверки конечных точек. Если вы нажмете Попробуйте! он отправит запрос с пустыми параметрами (без редактирования параметров запроса).
Ниже приведен файл моего urls.
Я использовал include()
, чтобы включить мои URL-адреса приложения, возможно, это причина, но затем, как она показывает некоторые URL-адреса и исключает некоторые.
urlpatterns = [
url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework')),
url(r'^api/v3/', include('identify.routers_v3', namespace='v3')),
# swagger schema url
url(r'^docs/', schema_view),
]
Я также проверил консоль и ошибок в консоли не было. Кроме того, я использую djnago отдых APIView
Ошибку, которую я получаю в окне браузера развязности является
{"schemaValidationMessages":[{"level":"error","message":"Can't read from file http://local.app.in:8000/docs/?format=openapi"}]}
Я перешел на использование Swagger UI и вручную документирования API, его не много усилий – Bitonator
У меня такая же проблема, и я думаю, что пойдет по тому же пути, что и вы. есть возможность вручную добавлять и редактировать объект coreapi.Document и генерировать схему из этого. Если кто-то найдет решение для этого, дайте свой ответ. – Erika
@ Эрика использует этот вопрос на github repo, я задал его вопрос, и проблема была исправлена. https://github.com/marcgibbons/django-rest-swagger/issues/562 – user5594493