customer api Swagger Specification - a fairly full example of a Swagger
specification for a typical RESTful service.