2016-10-12 6 views
2

Я только начал использовать 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"}]} 

enter image description here

+1

Я перешел на использование Swagger UI и вручную документирования API, его не много усилий – Bitonator

+0

У меня такая же проблема, и я думаю, что пойдет по тому же пути, что и вы. есть возможность вручную добавлять и редактировать объект coreapi.Document и генерировать схему из этого. Если кто-то найдет решение для этого, дайте свой ответ. – Erika

+0

@ Эрика использует этот вопрос на github repo, я задал его вопрос, и проблема была исправлена. https://github.com/marcgibbons/django-rest-swagger/issues/562 – user5594493

ответ

2

- Все ссылки не отображаются: Вышеуказанного связана с просьбой параметров передается в функции get_schema(), если вы удалите запрос, ваша проблема будет исправлена.

  • schemaValidationMessages - Это из-за недопустимый домен, домен был доступен с в локальной сети, как только я LocalHost, проблема будет исправлена.

Я спросил подобный вопрос о развязности GitHub репо так для больше информации обратитесь к этому вопросу на развязность мерзавец репо:

https://github.com/marcgibbons/django-rest-swagger/issues/562