Create Smart API Schema Descriptions

[rpwagner]

Create a schema for the Concierge Services based on the SmartAPI schema. Try to automate this as much as possible and store the scheme in the repo, or the means to generate it as needed.

[NickolausDS]

This project is based on Django Rest Framework and configured to use Django Rest Swagger for documenting REST endpoints. The canonical way to add documentation for rest endpoints with these tools is through the builtin DRF tools, which provide shorthands using docstrings. For example:

class BagViewSet(viewsets.ModelViewSet):
    """
    retrieve: Get information on a previously created bag

    list: List all bags which have been created
    """ 

Currently the API Permission settings don't allow users to see ALL the REST endpoints, only read-only ones (So only GET requests). This is a bit of a problem since users can't currently login through the web interface (Making them functional with logged in users would be extra work, since the REST endpoints currently expect tokens to be passed in the request header and not stored in user models). I think making the complete API visible could be solved in two different ways: Modifying the permissions to make endpoints visible through the API, or adding an OAuth login mechanism.

I can't be certain what other business logic SmartAPI is providing. It looks like it supports hosting a generated set of API docs on their site, is this what we want?