{"id":13516602,"url":"https://github.com/Mermade/openapi-specification-extensions","last_synced_at":"2025-03-31T06:31:29.292Z","repository":{"id":19159366,"uuid":"86355482","full_name":"Mermade/openapi-specification-extensions","owner":"Mermade","description":"A resource for common and standardised OpenAPI specification (vendor) extensions","archived":false,"fork":false,"pushed_at":"2024-04-17T14:04:00.000Z","size":256,"stargazers_count":47,"open_issues_count":1,"forks_count":10,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-11-01T21:34:52.115Z","etag":null,"topics":["analysis","openapi","swagger","swaggerhub","vendor-extension"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mermade.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-03-27T15:58:02.000Z","updated_at":"2024-08-28T04:15:22.000Z","dependencies_parsed_at":"2024-11-01T21:31:34.166Z","dependency_job_id":null,"html_url":"https://github.com/Mermade/openapi-specification-extensions","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mermade%2Fopenapi-specification-extensions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mermade%2Fopenapi-specification-extensions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mermade%2Fopenapi-specification-extensions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mermade%2Fopenapi-specification-extensions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mermade","download_url":"https://codeload.github.com/Mermade/openapi-specification-extensions/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246429459,"owners_count":20775805,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analysis","openapi","swagger","swaggerhub","vendor-extension"],"created_at":"2024-08-01T05:01:24.019Z","updated_at":"2025-03-31T06:31:25.693Z","avatar_url":"https://github.com/Mermade.png","language":null,"readme":"# openapi-specification-extensions\n\nA resource for common and standardised [OpenAPI specification](https://spec.openapis.org/oas/latest.html) (vendor) extensions.\n\nAs well as a list of vendor-documented specification-extensions, this repository contains the results of two analyses of extensions, formats and $ref siblings used in real-world OpenAPI definitions, as at late March 2017 and April 2021. \n\nSee also this [blog post](https://blog.postman.com/what-we-learned-from-200000-openapi-files/).\n\n## Vendor-documented extensions\n\n* [Adyen](https://github.com/Adyen/adyen-openapi#vendor-extensions)\n* [AIRR](http://docs.airr-community.org/en/latest/datarep/overview.html#airr-extension-properties)\n* [Alibaba Cloud API Gateway](https://www.alibabacloud.com/help/doc-detail/88956.htm)\n* [Amazon AWS](http://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html)\n* [api-ref-resolver](https://github.com/apiture/api-ref-resolver#readme)\n* [Apiary](https://help.apiary.io/api_101/swagger-extensions/)\n* [Apigee-127](https://github.com/apigee-127/a127-documentation/wiki/Swagger-specification-file#user-content-apigee-127-swagger-specification-reference)\n* [APIMatic](https://docs.apimatic.io/advanced/swagger-server-configuration-extensions/)\n* [APIs.guru](https://github.com/APIs-guru/openapi-directory/wiki/specification-extensions)\n* [Bump.sh](https://help.bump.sh/markdown-support#adding-topics-to-your-documentation)\n* [Bungie.net](https://github.com/Bungie-net/api#extension-properties-on-openapi-specs-or-how-to-generate-much-cooler-clients-for-the-bnet-api-if-you-want-to-take-the-time-to-do-so)\n* [DocuSign](https://github.com/docusign/eSign-OpenAPI-Specification/blob/master/DocuSign-Extensions.md)\n* [EVRYTHNG](https://developers.evrythng.com/docs/openapi-description#section-extensions)\n* [Exegesis](https://github.com/exegesis-js/exegesis/blob/master/docs/OAS3%20Specification%20Extensions.md)\n* [express-openapi](https://github.com/kogosoftwarellc/open-api/tree/master/packages/express-openapi#vendor-extensions)\n* [Fern](https://buildwithfern.com/docs/spec/extensions)\n* [GitHub](https://github.com/github/rest-api-description/blob/main/extensions.md)\n* [go-swagger](https://goswagger.io/use/models/schemas.html#custom-extensions)\n* [Google Cloud Endpoints](https://cloud.google.com/endpoints/docs/openapi/openapi-extensions)\n* [IBM API Connect](https://www.ibm.com/support/knowledgecenter/SSMNED_5.0.0/com.ibm.apic.toolkit.doc/rapim_cli_swagger_extensions.html)\n* [IBM Watson Orchestrate](https://www.ibm.com/docs/en/watson-orchestrate?topic=documents-openapi-specification-extensions)\n* [Kusk](https://kubeshop.github.io/kusk/openapi-extension/)\n* [Kusk Gateway](https://kubeshop.github.io/kusk-gateway/extension/)\n* [Microsoft Azure](https://github.com/Azure/autorest/tree/master/docs/extensions)\n* [Microsoft Connectors](https://docs.microsoft.com/en-us/connectors/custom-connectors/openapi-extensions)\n* [Microsoft Flow](https://flow.microsoft.com/en-us/documentation/customapi-how-to-swagger/)\n* [Microsoft Typespec (fka Cadl)](https://microsoft.github.io/typespec/next/standard-library/openapi/reference/js-api#getopenapitypename)\n* [Nintex Workflow Cloud](https://help.nintex.com/en-US/xtensions/04_Reference/REF_OpenAPISwipeFile.htm#OpenAPI_Specification_Extensions)\n* [NSwagStudio/NJsonSchema](https://github.com/rsuter/NJsonSchema/wiki/Enums) - documentation pending (x-typeName, x-enumNames)\n* [ReadMe.io](https://docs.readme.com/docs/openapi-extensions)\n* [Red Hat Fuse Online](https://access.redhat.com/documentation/en-us/red_hat_fuse/7.5/html/integrating_applications_with_fuse_online/customizing_ug#providing-client-credentials_dev-client-connector)\n* [Redocly](https://redocly.com/docs/api-reference-docs/spec-extensions/)\n* [RepreZen Swagger-Normalizer](http://docs.reprezen.com/swagger_normalizer/)\n* [Restish](https://rest.sh/#/openapi?id=openapi-extensions)\n* [SAP OpenAPI Specification Extensions for the SAP Ecosystem](https://github.com/sap/OpenAPI-Specification)\n* [Speakeasy](https://www.speakeasyapi.dev/docs/customize-sdks#x-speakeasy-extensions)\n* [Spring Cloud Contract OpenAPI 3.0 Converter](https://github.com/springframeworkguru/spring-cloud-contract-oa3#defining-contracts-in-openapi)\n* [SQL-Translator-Parser-OpenAPI](https://metacpan.org/pod/SQL::Translator::Parser::OpenAPI#OPENAPI-SPEC-EXTENSIONS)\n* [Stoplight](https://meta.stoplight.io/docs/platform/x8m99p1dhhvl8-extensions#stoplight-extensions)\n* [Stripe](https://github.com/stripe/openapi#vendor-extensions)\n* [swagger-codegen](https://github.com/swagger-api/swagger-codegen/wiki/Vendor-Extensions)\n* [SwaggerHub](https://app.swaggerhub.com/help/apis/vendor-extensions)\n* [swaggerplusplus](https://github.com/mermade/swaggerplusplus)\n* [Twilio](https://github.com/twilio/guardrail/blob/master/modules/microsite/docs/scala/akka-http/guardrail-extensions.md)\n* [TypeForm OpenAPI-micro-merge](https://github.com/Typeform/openapi-micro-merge#extensions)\n* [Unisys COBOL](https://public.support.unisys.com/ePortalIC-10.0/index.jsp?topic=%2F82073594_clearpath_eportal_developerhelp%2Fhtml%2Fsection-000064331.htm)\n* [Vert.x](https://vertx.io/docs/vertx-web-api-service/java/#_using_the_extension_code_x_vertx_event_bus_code)\n* WaveMaker Studio (x-WM- extensions) - documentation pending\n* [WSO2 API Microgateway](https://docs.wso2.com/display/MG300/Supported+OpenAPI+Extensions)\n* [Yandex API Gateway](https://cloud.yandex.com/en/docs/api-gateway/concepts/extensions/)\n* [Zuplo](https://zuplo.com/docs/articles/open-api#zuplo-extensions)\n\n## Analysis of specification-extensions\n\n### 2021\n\nFacet|Analysis\n|---|---|\nExtensions|[193953 definitions](extensions/2021/extensions.tsv)\nFormats|[193953 definitions](formats/2021/formats.tsv)\nRef Sibling|[193953 definitions](refs/2021/refs.tsv)\n\n### 2017\n\n### Analysis of extensions\n\nSource|Analysis\n|---|---|\n[APIs.guru](https://github.com/apis-guru/openapi-directory)|[391 definitions](extensions/2017/apis-guru.tsv)\n[GitHub](https://github.com/)|[25136 definitions](extensions/2017/github.tsv)\n[Mermade](https://github.com/mermade/openapi-definitions)|[454 definitions](extensions/2017/mermade.tsv)\n[SOM Research HAPI](https://github.com/som-research/hapi)|[513 definitions](extensions/2017/hapi.tsv)\n[SwaggerHub](http://swaggerhub.com)|[22872 definitions](extensions/2017/swaggerhub.tsv)\nCombined|[49366 definitions](extensions/2017/combined.tsv)\n\n#### Analysis of formats\n\nSource|Analysis\n|---|---|\n[APIs.guru](https://github.com/apis-guru/openapi-directory)|[391 definitions](formats/2017/apis-guru.tsv)\n[GitHub](https://github.com/)|[25136 definitions](formats/2017/github.tsv)\n[Mermade](https://github.com/mermade/openapi-definitions)|[454 definitions](formats/2017/mermade.tsv)\n[SOM Research HAPI](https://github.com/som-research/hapi)|[513 definitions](formats/2017/hapi.tsv)\n[SwaggerHub](http://swaggerhub.com)|[22872 definitions](formats/2017/swaggerhub.tsv)\nCombined|[49366 definitions](formats/2017/combined.tsv)\n\n#### Analysis of $refs with additional properties\n\nSource|Analysis\n|---|---|\nCombined|[49366 definitions](refs/2017/combined.csv)\n\n","funding_links":[],"categories":["Technical"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMermade%2Fopenapi-specification-extensions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMermade%2Fopenapi-specification-extensions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMermade%2Fopenapi-specification-extensions/lists"}