Skip to main content

AWS API Gateway OpenAPI spec linter

Project description

OpenAPI AWS API Gateway linter

codecov license

AWS-OpenAPI-Lint is a simple OpenAPI 3 yaml / json spec linter designed for checking API Gateway integration.


It contains rules for checking whether:

  • you have an authorizer on OPTIONS
  • authorizer is mentioned in requestParameters but is not present in security
  • http verbs are consistent in the path and integration
  • all used headers in path from all verbs are mentioned in CORS rules and vice-versa
  • CORS rules allow all verbs mentioned in the path
  • CORS rules are present
  • amazon integration is present
  • path parameters present in requestParameters are not used in the direct path parameters and vice-versa


  • [ ] Update README with rule names and behavior
  • [X] Support json specs
  • [X] Add optional rule for checking base url equality
  • [ ] Add support for configuration yaml file
  • [ ] Add possibility to disable rule checking on specific paths
  • [ ] Add possibility to disable rules per path
  • [ ] Ignore path-params if http_proxy integration type used
  • [X] Add option to disable rules via CLI
  • [X] Add warning threshold to return with status code 0 if limit not exceeded
  • [X] Fix flake8 violations
  • [X] Add a license
  • [X] Publish to PyPI or alike
  • [X] Configure properly up GitHub actions to run tests on push


pip install aws-openapi-lint


$ aws-openapi-lint path/to/spec.yml

usage: [-h] [--treat-errors-as-warnings]
               [--warning-threshold WARNING_THRESHOLD]
               [--exclude-rules EXCLUDE_RULES]

Lint OpenAPI specifications based on AWS API Gateway.

positional arguments:
  lint_file             Specify path to the openapi schema file.

optional arguments:
  -h, --help            show this help message and exit
                        Treats errors as warnings (exit code will be 0 unless
                        warning threshold is specified
  --warning-threshold WARNING_THRESHOLD
                        Warning threshold which when surpassed renders exit
                        code to become 1)
  --exclude-rules EXCLUDE_RULES
                        Excluded rules separated by comma.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for AWS-OpenAPI-Lint, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size AWS-OpenAPI-Lint-0.2.1.tar.gz (7.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page