Document API (using swagger and docstrings)

[zen]

We need to document existing API methods. It can be easily achieved with docstrings for Views
http://www.django-rest-framework.org/topics/documenting-your-api/