2

我刚开始在我的 API 文档中使用 swagger。我关注了这些文档,但超过一半的网址被大摇大摆地排除在外。

如下图所示,它显示了一些 url,但很少有 url 被排除在外,并且 swagger 显示的 url 不包括完整的功能,例如没有用于测试端点的正文部分。如果你点击试试看!它将发送带有空白参数的请求(没有正文来编辑请求参数)。

下面是我的网址文件。

我曾经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 restAPIView

我在招摇浏览器屏幕中遇到的错误是

{"schemaValidationMessages":[{"level":"error","message":"Can't read from file http://local.app.in:8000/docs/?format=openapi"}]}

在此处输入图像描述

4

1 回答 1

2

- 所有 url 未映射: 以上是由于 get_schema() 函数中传递的请求参数,如果您删除请求,您的问题将得到解决。

  • schemaValidationMessages- 这是由于域无效,只要我使用 localhost,就可以在 Intranet 中访问该域,问题得到解决。

我在 swagger github repo 上问过类似的问题,因此有关更多信息,请参阅 swagger git repo 上的这个问题:

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

于 2016-10-20T10:17:34.843 回答