For the title/description, use something like this in your settings.py:
SWAGGER_SETTINGS = {
'info': {
'title': 'API Title',
'description': """Description text body""",
}
}
For response schema generation, that worked in the now-deprecated version
0.3, and the Django Rest Swagger broke it by migrating to DRF's built-in
schema generation before it was finished. I just use 0.3, since I want
response schemas in my docs.
The DRF issue you linked to is the one to follow; when that one is
resolved, DR Swagger should re-learn how to do response schemas.
On Monday, May 29, 2017 at 8:50:07 AM UTC-7, Abraham Varricatt wrote:
>
> Hello,
>
> I've built an API using Django REST Framework (using viewsets and
> registering them with simpleRouter()). After this, I installed
> django-rest-swagger (ref:
> http://marcgibbons.github.io/django-rest-swagger/ ).
>
> Is it possible to write a description for a website, to show in the
> swagger UI? For reference in here,
>
> http://petstore.swagger.io/
>
> If you open that link on desktop, there is a part which says 'This is a
> sample server Petstore ....'. There are even a few links as a part of it.
> Is it possible to have this information for us too, using
> django-rest-swagger ?
>
> A separate concern (and frustration) I have is the inability to describe a
> response format for the different APIs. There's a github issue about it:
> https://github.com/encode/django-rest-framework/issues/4502 so, I just
> want to say that it's eagerly awaited.
>
> Yours sincerely,
> Abraham V.
>
>
--
You received this message because you are subscribed to the Google Groups
"Django REST framework" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to django-rest-framework+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
