(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.