Combining Django Rest Framework, JSON API Specification and Swagger documentation to expose a self-documenting, RESTful API to SQL tables (all in under 5 minutes). These slides originally accompanied a presentation at Django meet-up group demo at Wiredrive 2016. https://github.com/byrondover/ladjango-demo https://www.meetup.com/ladjango https://www.meetup.com/ladjango/events/232362473

1. Building REST APIs with Django
Create your own self-describing and specification-compliant APIs in minutes.

2. Keep in touch!
@byrondover

3. Four Technologies
1. Django
2. Django Rest Framework
3. JSON API Specification
4. Swagger

4. Technology #1

5. Migrations

6. Using inspectdb

7. Technology #2

8. Django REST Framework

9. Django REST Framework

10. Technology #3

11. JSON API

12. JSON API

13. JSON API

14. SWAGGER
Technology #4

15. Swagger Request
Self-describing.
Self-documenting.
Programmatically accessible. GET /api-docs?format=openapi HTTP/1.1

16. Swagger Response
Human-readable.
Machine-readable.
Precisely describes your API
contract.

17. Putting it all together...

18. inspectdb (Django)
+
Django Rest Framework (djangorestframework)
+
JSON API Specification
(djangorestframework-jsonapi)
+
Swagger Schema (django-rest-swagger)

19. Stop! Demo Time

20. Questions?
References
http://dev.mysql.com/doc/index-other.html
http://www.django-rest-framework.org
https://www.djangoproject.com
https://github.com/byrondover/ladjango-demo
https://github.com/django-json-api/django-rest-framework-json-api