openapi-specification-extensions

A resource for common and standardised OpenAPI specification (vendor) extensions.

As well as a list of vendor-documented specification-extensions, this repository contains the results of an analysis of extensions and formats used in real-world OpenAPI definitions, as at late March 2017. It is also planned to replicate this analysis but on a much larger scale.

Vendor-documented extensions

• Adyen
• AIRR
• Alibaba Cloud API Gateway
• Amazon AWS
• api-ref-resolver
• Apiary
• Apigee-127
• APIMatic
• APIs.guru
• Bump.sh
• Bungie.net
• Cadl
• DocuSign
• EVRYTHNG
• Exegesis
• express-openapi
• GitHub
• go-swagger
• Google Cloud Endpoints
• IBM API Connect
• Kusk
• Kusk Gateway
• Microsoft Azure
• Microsoft Connectors
• Microsoft Flow
• Nintex Workflow Cloud
• NSwagStudio/NJsonSchema - documentation pending (x-typeName, x-enumNames)
• ReadMe.io
• Rebilly Redoc
• Red Hat Fuse Online
• RepreZen Swagger-Normalizer
• Restish
• SAP OpenAPI Specification Extensions for the SAP Ecosystem
• Spring Cloud Contract OpenAPI 3.0 Converter
• SQL-Translator-Parser-OpenAPI
• Stripe
• swagger-codegen
• SwaggerHub
• swaggerplusplus
• Twilio
• TypeForm OpenAPI-micro-merge
• Unisys COBOL
• Vert.x
• WaveMaker Studio (x-WM- extensions) - documentation pending
• WSO2 API Microgateway
• Yandex API Gateway
• Zuplo

Analysis of specification-extensions

Source	Analysis
APIs.guru	391 definitions
GitHub	25136 definitions
Mermade	454 definitions
SOM Research HAPI	513 definitions
SwaggerHub	22872 definitions
Combined	49366 definitions

Analysis of formats

Source	Analysis
APIs.guru	391 definitions
GitHub	25136 definitions
Mermade	454 definitions
SOM Research HAPI	513 definitions
SwaggerHub	22872 definitions
Combined	49366 definitions

Analysis of $refs with additional properties

Source	Analysis
Combined	49366 definitions