Comment by apatap

Amazon API Gateway supports OpenAPI (http://swagger.io/) via Console and AWS-CLI.

(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/) seems to be also around the corner. (https://github.com/awslabs/aws-apigateway-importer)

"API First" is in general quite promising.