aws2openapi icon indicating copy to clipboard operation
aws2openapi copied to clipboard

Amazon Web Services API description to OpenAPI 3.0 definition

aws2openapi

Amazon Web Services API description to OpenAPI 3.0 specification

Work in progress - beta quality

Handles all current (v2) AWS json and xml specifications

Resultant OpenApi specifications pass multiple validators

screenshot

The results of this converter can be found here

TODO help wanted

  • ~~Fix input header parameter selectivity~~
  • ~~Process protocol:ec2~~
  • ~~Authentication~~ You will have to calculate HMAC headers manually
  • ~~pagination~~
  • ~~Examples~~
  • ~~Waiters~~ (as vendor extension)
  • Test against live endpoints
  • Verify output header mappings
  • Test path-with-fragment hack works
  • Test paths with hardcoded ?parameters work
  • Validate xml-handling keyword translations