Use Swagger for ReSTful API

With the BEAT deliverables out of the way, it would be nice to think about a longer term documentation strategy for our web APIs. Now everything (please correct me if I'm wrong) uses Django's rest framework, it would be good to go for Swagger. It is, at least, the recommendation from that library: http://www.django-rest-framework.org/topics/documenting-your-api/