Amazon API Gateway supports OpenAPI (http://swagger.io/ http://swagger.io/) via Console and AWS-CLI. (http://docs.aws.amazon.com/cli/latest/reference/apigatewa

Amazon API Gateway supports OpenAPI (http://swagger.io/ http://swagger.io/) via Console and AWS-CLI. (http://docs.aws.amazon.com/cli/latest/reference/apigateway/put-rest-api.html http://docs.aws.amazon.com/cli/latest/reference/apigateway/p...) This approach allows to avoid a lot of the mentioned Amazon API Gateway hassle. RAML (http://raml.org/ http://raml.org/) seems to be also around the corner. (https://github.com/awslabs/aws-apigateway-importer https://github.com/awslabs/aws-apigateway-importer) "API First" is in general quite promising.