https://github.com/apis-guru/aws2openapi

Amazon Web Services API description to OpenAPI 3.0 definition
https://github.com/apis-guru/aws2openapi

amazon amazon-api amazon-s3-storage amazon-web-services aws openapi openapi3 swagger

Last synced: 8 days ago
JSON representation

Amazon Web Services API description to OpenAPI 3.0 definition

• Host: GitHub
• URL: https://github.com/apis-guru/aws2openapi
• Owner: APIs-guru
• License: mit
• Created: 2016-09-15T08:36:59.000Z (about 8 years ago)
• Default Branch: main
• Last Pushed: 2023-02-15T18:06:59.000Z (over 1 year ago)
• Last Synced: 2024-05-01T09:44:54.379Z (7 months ago)
• Topics: amazon, amazon-api, amazon-s3-storage, amazon-web-services, aws, openapi, openapi3, swagger
• Language: JavaScript
• Homepage: https://github.com/APIs-guru/openapi-directory/tree/master/APIs/amazonaws.com
• Size: 220 KB
• Stars: 53
• Watchers: 5
• Forks: 10
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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](https://github.com/OAI/OpenAPI-Specification/blob/master/schemas/v3.0/schema.yaml) [validators](https://github.com/Mermade/oas-kit)

![screenshot](https://raw.githubusercontent.com/APIs-guru/aws2openapi/main/docs/screenshot.png)

The results of this converter can be found [here](https://github.com/APIs-guru/openapi-directory/tree/master/APIs/amazonaws.com)

### 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