Use Swagger compatible api description

[mallocator]

Since there's a standard to describe RESTful APIs the server should follow that standard. This will make it easier to integrate with other services that understand the format.