Need advice about which tool to choose?Ask the StackShare community!

Django REST framework

1.8K
1.9K
+ 1
304
Swagger UI

1.8K
1.6K
+ 1
205
Add tool

Django REST framework vs Swagger UI: What are the differences?

Developers describe Django REST framework as "Web APIs for Django". Django REST framework is a powerful and flexible toolkit that makes it easy to build Web APIs. On the other hand, Swagger UI is detailed as "dependency-free collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation". Swagger UI is a dependency-free collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation and sandbox from a Swagger-compliant API.

Django REST framework belongs to "Microframeworks (Backend)" category of the tech stack, while Swagger UI can be primarily classified under "Documentation as a Service & Tools".

"Browsable api" is the primary reason why developers consider Django REST framework over the competitors, whereas "Open Source" was stated as the key factor in picking Swagger UI.

Django REST framework is an open source tool with 14.7K GitHub stars and 4.33K GitHub forks. Here's a link to Django REST framework's open source repository on GitHub.

According to the StackShare community, Swagger UI has a broader approval, being mentioned in 205 company stacks & 107 developers stacks; compared to Django REST framework, which is listed in 159 company stacks and 79 developer stacks.

Advice on Django REST framework and Swagger UI
kristan-dev
Senior Solutions Analyst · | 8 upvotes · 259.1K views

My journey to developing REST APIs started with Flask Restful, and I've found it to be enough for the needs of my project back then. Now that I've started investing more time on personal projects, I've yet to decide if I should move to use Django for writing REST APIs. I often see job posts looking for Python+Django developers, but it's usually for full-stack developers. I'm primarily interested in Data Engineering, so most of my web projects are back end.

Should I continue with what I know (Flask) or move on to Django?

See more
Replies (1)
Rafael Torres
Technical Lead at 4Agile · | 9 upvotes · 249.8K views

If you want to be a Web developer with knowledge in another frontend and NoSql technology, maybe continue with Flask. However, if you want to create very fast solutions to grow up with a new business and merge these with data analysis and other tools, Django is the answer. Basically read more about the service architecture where you feel more comfortable, Microservice or Monolithic, but please will not married with any because they solve issues to different contexts.

See more
Saurav Pandit
Application Devloper at Bny Mellon · | 5 upvotes · 210.7K views

I have just started learning Python 3 weeks ago. I want to create a REST API using python. The API will be used to save form data in an Oracle database. The front end is using AngularJS 8 with Angular Material. In python, there are so many frameworks to develop REST APIs.

I am looking for some suggestions which REST framework to choose?

Here are some features I am looking for:

  • Easy integration and unit testing, like in Angular. We just want to run a command.

  • Code packaging, like in java maven project we can build and package. I am looking for something which I can push in as an artifact and deploy whole code as a package.

  • Support for swagger/ OpenAPI

  • Support for JSON Web Token

  • Support for test case coverage report

Framework can have features included or can be available by extension. Also, you can suggest a framework other than the ones I have mentioned.

See more
Replies (1)
Recommends
FlaskFlask
at

For starters flask provides a beautiful and easy way to create REST APIs. Also its supported by excellent beginner docs as well as a very active community. Another good thing with Flask is its widely available list of plugins which allow you to build as you go. Its also good in performance and can scale to a quite decent level. However, if you are sure your project is going to be fairly big, it would be better to start with Django as it provides a lot of features out of the box and is extremely stable in performance. Both these frameworks have support for Swagger, JWT, Coverage Report although you have to install plugins for them. Deploying both of these are fairly simple and there is huge documentation available. Django has one of the best documentations I have come across. I hope I was able to answer your queries.

See more
Needs advice
on
PostmanPostmanApiaryApiary
and
Swagger UISwagger UI

From a StackShare Community member: "I just started working for a start-up and we are in desperate need of better documentation for our API. Currently our API docs is in a README.md file. We are evaluating Postman and Swagger UI. Since there are many options and I was wondering what other StackSharers would recommend?"

See more
Replies (3)
Jagdeep Singh
Tech Lead at ucreate.it · | 8 upvotes · 294.2K views

I use Postman because of the ease of team-management, using workspaces and teams, runner, collections, environment variables, test-scripts (post execution), variable management (pre and post execution), folders (inside collections, for better management of APIs), newman, easy-ci-integration (and probably a few more things that I am not able to recall right now).

See more

I use Swagger UI because it's an easy tool for end-consumers to visualize and test our APIs. It focuses on that ! And it's directly embedded and delivered with the APIs. Postman's built-in tools aren't bad, but their main focus isn't the documentation and also, they are hosted outside the project.

See more
Sadik Ay
Recommends
PostmanPostman

I recommend Postman because it's easy to use with history option. Also, it has very great features like runner, collections, test scripts runners, defining environment variables and simple exporting and importing data.

See more
Get Advice from developers at your company using StackShare Enterprise. Sign up for StackShare Enterprise.
Learn More
Pros of Django REST framework
Pros of Swagger UI
  • 65
    Easy to use
  • 64
    Browsable api
  • 53
    Great documentation
  • 49
    Customizable
  • 41
    Fast development
  • 9
    Easy to use, customizable, pluggable, serializer
  • 8
    Python
  • 6
    Django ORM
  • 5
    FastSerialize
  • 2
    Less code
  • 2
    Easy implementation
  • 47
    Open Source
  • 34
    Can execute api calls from the documentation
  • 29
    Free to use
  • 19
    Customizable
  • 14
    Easy to implement in .Net
  • 13
    Mature, clean spec
  • 12
    API Visualization
  • 9
    Coverage
  • 6
    Scaffolding
  • 6
    Easy to use
  • 5
    Vibrant and active community
  • 4
    Elegant
  • 3
    Adopted by tm forum api
  • 2
    Clear for React
  • 1
    Api
  • 1
    Can deploy API to AWS API Gateway and AWS Lambda

Sign up to add or upvote prosMake informed product decisions

Cons of Django REST framework
Cons of Swagger UI
  • 2
    Bad documentation
  • 2
    Reimplements Django functionality
  • 1
    No support for URL Namespaces
  • 0
    Bad CSRF handling
  • 3
    Need to learn YAML and RAML
  • 2
    Documentation doesn't look that good
  • 1
    Doesn't generate code snippets in different languages
  • 1
    You don’t actually get in-line error highlighting
  • 1
    Does not support hypermedia

Sign up to add or upvote consMake informed product decisions

- No public GitHub repository available -

What is Django REST framework?

It is a powerful and flexible toolkit that makes it easy to build Web APIs.

What is Swagger UI?

Swagger UI is a dependency-free collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation and sandbox from a Swagger-compliant API

Need advice about which tool to choose?Ask the StackShare community!

Jobs that mention Django REST framework and Swagger UI as a desired skillset
CBRE
United Kingdom of Great Britain and Northern Ireland England London
CBRE
United Kingdom of Great Britain and Northern Ireland England Gloucester
What companies use Django REST framework?
What companies use Swagger UI?
See which teams inside your own company are using Django REST framework or Swagger UI.
Sign up for StackShare EnterpriseLearn More

Sign up to get full access to all the companiesMake informed product decisions

What tools integrate with Django REST framework?
What tools integrate with Swagger UI?

Sign up to get full access to all the tool integrationsMake informed product decisions

Blog Posts

GitHubPythonReact+42
48
40061
GitHubPythonNode.js+47
53
70917
PythonDjangoDjango REST framework+3
6
5462
What are some alternatives to Django REST framework and Swagger UI?
Django
Django is a high-level Python Web framework that encourages rapid development and clean, pragmatic design.
Flask
Flask is intended for getting started very quickly and was developed with best intentions in mind.
Tastypie
Tastypie is a webservice API framework for Django. It provides a convenient, yet powerful and highly customizable abstraction for creating REST-style interfaces.
Graphene
Graphene is a Python library for building GraphQL schemas/types fast and easily.
Spring Boot
Spring Boot makes it easy to create stand-alone, production-grade Spring based Applications that you can "just run". We take an opinionated view of the Spring platform and third-party libraries so you can get started with minimum fuss. Most Spring Boot applications need very little Spring configuration.
See all alternatives