OpenAPITools/openapi-diff

Voir sur GitHub

Utility for comparing two OpenAPI specifications.

Étoiles: 1.1k
Forks: 190
Issues débutants ouvertes: 0
Issues indexées: 69

Langage dominant: Java
Licence: Apache-2.0
Dernier push GitHub: 5/8/2026
Dernière indexation: 19/9/2026
Guide de contribution: Guide de contribution
Code de conduite: Code de conduite
Labels débutants: help wanted good first issue
Métriques de merge des PR: Aucune PR mergée en 30 j

Accessible aux débutants Tout

Ouverte Toutes

69 issues ouvertes indexées

Property `type` change on referenced component schema is silently ignored Ouverte

bug OpenAP 3.1.0 Support

Difficulté 3/5 1-2 jours Accessibilité débutants 68/100

OpenAPITools/openapi-diff#910 · 1 commentaire · Ouverte le 12/6/2026
Changes reported in operations but only securityScheme changed Ouverte

Render capabilities

Difficulté 3/5 1-2 jours Accessibilité débutants 55/100

OpenAPITools/openapi-diff#893 · 1 commentaire · Ouverte le 25/2/2026
[Bug] Backward compatibility check fails on reordered discriminator mappings Ouverte

Breaking/Non-Breaking classification

Difficulté 3/5 1-2 jours Accessibilité débutants 55/100

OpenAPITools/openapi-diff#886 · Ouverte le 30/1/2026
Feature Request: generate Overlay for the given 2 OpenAPI files Ouverte

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100

OpenAPITools/openapi-diff#883 · Ouverte le 20/1/2026
Renderers should display example changes, not just schema changes Ouverte

Render capabilities

Difficulté 3/5 1-2 jours Accessibilité débutants 48/100

OpenAPITools/openapi-diff#872 · Ouverte le 28/11/2025
Operations are detected as changed when comparing for open api version 3.0.1 and 3.1.0 Ouverte

OpenAP 3.1.0 Support

Difficulté 3/5 1-2 jours Accessibilité débutants 45/100

OpenAPITools/openapi-diff#858 · Ouverte le 7/11/2025
Operation description change is detected as a change but it is not rendered by HtmlRender Ouverte

Render capabilities

Difficulté 3/5 1-2 jours Accessibilité débutants 45/100

OpenAPITools/openapi-diff#857 · Ouverte le 7/11/2025
TeamCity renderer Ouverte

Render capabilities

Difficulté 4/5 3-5 jours Accessibilité débutants 35/100

OpenAPITools/openapi-diff#849 · Ouverte le 14/10/2025
ExtensionDiff in renderers (just tried console and html) Ouverte

enhancement Render capabilities

Difficulté 3/5 1-2 jours Accessibilité débutants 35/100

OpenAPITools/openapi-diff#839 · 1 commentaire · Ouverte le 25/9/2025
Mark down changelog generation - enum rename interpreted as added Ouverte

OpenAPITools/openapi-diff#828 · 1 commentaire · 1 réaction · 1 personne assignée · Ouverte le 11/9/2025
IllegalArgumentException: "Invalid ref..." when uses an external link like "../demo#/components" Ouverte

Difficulté 3/5 1-2 jours Accessibilité débutants 35/100

OpenAPITools/openapi-diff#810 · 2 commentaires · 1 réaction · Ouverte le 11/8/2025
Bug: erroneous detection of changes with mediaTypes, failure to generate html/markdown reports Ouverte

Difficulté 3/5 1-2 jours Accessibilité débutants 45/100

OpenAPITools/openapi-diff#805 · 1 commentaire · Ouverte le 7/8/2025
Bug: no details when securitySchemes.*.name changes Ouverte

OpenAP 3.1.0 Support

Difficulté 3/5 1-2 jours Accessibilité débutants 45/100

OpenAPITools/openapi-diff#802 · Ouverte le 17/7/2025
Changing response field type from `oneOf: string, number` to `string` shouldn't break Ouverte

Breaking/Non-Breaking classification

Difficulté 3/5 1-2 jours Accessibilité débutants 48/100

OpenAPITools/openapi-diff#798 · 4 commentaires · Ouverte le 4/7/2025
Changing request field type from `string` to `oneOf: string, number` shouldn't break Ouverte

Breaking/Non-Breaking classification

Difficulté 3/5 1-2 jours Accessibilité débutants 50/100

OpenAPITools/openapi-diff#797 · Ouverte le 4/7/2025
Support for detecting changes in webhooks Ouverte

OpenAP 3.1.0 Support

Difficulté 4/5 3-5 jours Accessibilité débutants 42/100

OpenAPITools/openapi-diff#793 · Ouverte le 17/6/2025
Exception in thread "main" java.lang.StackOverflowError Ouverte

bug

Difficulté 4/5 3-5 jours Accessibilité débutants 35/100

OpenAPITools/openapi-diff#788 · Ouverte le 26/5/2025
Unify Handling of allOf/anyOf and oneOf in Diff logic Ouverte

enhancement

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 35/100

OpenAPITools/openapi-diff#772 · Ouverte le 22/4/2025
Markdown output does not specify whether the change is backward-compatible or not Ouverte

Breaking/Non-Breaking classification Render capabilities

Difficulté 3/5 1-2 jours Accessibilité débutants 48/100

OpenAPITools/openapi-diff#766 · 1 commentaire · 1 réaction · Ouverte le 5/4/2025
Comparing OpenAPI 3.0.1 to 3.1.0 does not work Ouverte

OpenAP 3.1.0 Support

Difficulté 4/5 3-5 jours Accessibilité débutants 35/100

OpenAPITools/openapi-diff#755 · 5 commentaires · 1 réaction · Ouverte le 14/3/2025
[OpenAPI 3.1.0 support] JsonSchema type changes not handled. Ouverte

OpenAP 3.1.0 Support

Difficulté 4/5 3-5 jours Accessibilité débutants 35/100

OpenAPITools/openapi-diff#745 · Ouverte le 10/2/2025
Missing #/components/securitySchemes section leads to IllegalArgumentException Ouverte

good first issue help wanted

Difficulté 3/5 1-2 jours Accessibilité débutants 45/100

OpenAPITools/openapi-diff#737 · Ouverte le 30/1/2025
Schema description update should be considered as a metadata change Ouverte

Breaking/Non-Breaking classification duplicate

Difficulté 3/5 1-2 jours Accessibilité débutants 45/100

OpenAPITools/openapi-diff#694 · 2 commentaires · Ouverte le 13/8/2024
Deleted or renamed properties are marked as backwards compatible Ouverte

Breaking/Non-Breaking classification

Difficulté 3/5 1-2 jours Accessibilité débutants 52/100

OpenAPITools/openapi-diff#673 · 7 commentaires · 3 réactions · Ouverte le 14/6/2024
Report totals Ouverte

enhancement

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100

OpenAPITools/openapi-diff#627 · 1 réaction · Ouverte le 5/3/2024
Output in text and markdown not equivalent (text output incomplete) Ouverte

enhancement Render capabilities

Difficulté 4/5 3-5 jours Accessibilité débutants 30/100

OpenAPITools/openapi-diff#620 · 2 commentaires · 1 réaction · Ouverte le 19/2/2024
No backward compatible changes in Schema are marked as Compatible Ouverte

Breaking/Non-Breaking classification

Difficulté 4/5 3-5 jours Accessibilité débutants 35/100

OpenAPITools/openapi-diff#611 · 4 réactions · Ouverte le 16/1/2024
The current openapi-diff implementation does not capture differences in extensions that occur at the properties level (attributes under the type object) and the path level Ouverte

Difficulté 4/5 3-5 jours Accessibilité débutants 30/100

OpenAPITools/openapi-diff#604 · Ouverte le 28/12/2023
Removing a mandatory or optional property in the input data : breaking change ? Ouverte

Breaking/Non-Breaking classification question

Difficulté 4/5 3-5 jours Accessibilité débutants 25/100

OpenAPITools/openapi-diff#599 · 2 commentaires · Ouverte le 19/12/2023
[bug] [polymorphism] Changes in child schema are ignored when only parent schema is directly referenced Ouverte

Difficulté 4/5 3-5 jours Accessibilité débutants 38/100

OpenAPITools/openapi-diff#571 · 1 commentaire · Ouverte le 21/9/2023
--json output is absurdly huge Ouverte

enhancement Render capabilities

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100

OpenAPITools/openapi-diff#562 · 1 commentaire · 8 réactions · Ouverte le 8/9/2023
incompatible api diff result when one of property in model becomes not required Ouverte

Breaking/Non-Breaking classification

Difficulté 3/5 1-2 jours Accessibilité débutants 38/100

OpenAPITools/openapi-diff#535 · 2 commentaires · 1 réaction · Ouverte le 22/6/2023
[2.1.0-beta.6 and oas-3.1.0] Request body property data type change is detected as compatible or no_change Ouverte

Breaking/Non-Breaking classification

Difficulté 3/5 1-2 jours Accessibilité débutants 38/100

OpenAPITools/openapi-diff#528 · 1 commentaire · 3 réactions · Ouverte le 2/6/2023
enum and properties change in schemas not reported in .md file generated after diff check Ouverte

Difficulté 4/5 3-5 jours Accessibilité débutants 42/100

OpenAPITools/openapi-diff#523 · Ouverte le 17/5/2023
`--state` option outputs `metadata` Ouverte

good first issue

Difficulté 2/5 1-3 heures Accessibilité débutants 50/100

OpenAPITools/openapi-diff#508 · Ouverte le 18/4/2023
In openapi-diff-cli add old and new filenames to the output Ouverte

enhancement

Difficulté 2/5 1-3 heures Accessibilité débutants 68/100

OpenAPITools/openapi-diff#506 · Ouverte le 4/4/2023
False positive when adding optional property Ouverte

Breaking/Non-Breaking classification

Difficulté 3/5 1-2 jours Accessibilité débutants 42/100

OpenAPITools/openapi-diff#490 · 3 commentaires · 1 réaction · Ouverte le 14/3/2023
Using a reference in items of array results in error Ouverte

duplicate

Difficulté 3/5 1-2 jours Accessibilité débutants 20/100

OpenAPITools/openapi-diff#464 · 3 commentaires · Ouverte le 15/2/2023
Do not fail with breaking changes when major version is bumped Ouverte

Breaking/Non-Breaking classification enhancement

Difficulté 4/5 3-5 jours Accessibilité débutants 35/100

OpenAPITools/openapi-diff#460 · 2 commentaires · Ouverte le 3/2/2023
Removing a Query parameter is considered a breaking change while removing a Request Body parameter isn't Ouverte

Breaking/Non-Breaking classification help wanted

Difficulté 3/5 1-2 jours Accessibilité débutants 25/100

OpenAPITools/openapi-diff#412 · 1 commentaire · Ouverte le 15/9/2022
allOf : `type` of property contained in multiple subschemas is not correctly determined. Ouverte

Difficulté 3/5 1-2 jours Accessibilité débutants 35/100

OpenAPITools/openapi-diff#392 · 4 commentaires · 2 réactions · Ouverte le 4/7/2022
Consider removal of deprecated elements as compatible Ouverte

Breaking/Non-Breaking classification

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 20/100

OpenAPITools/openapi-diff#371 · 4 commentaires · Ouverte le 5/5/2022
HtmlRender: Notes of Parameters shows always the new description Ouverte

good first issue help wanted

Difficulté 2/5 1-3 heures Accessibilité débutants 68/100

OpenAPITools/openapi-diff#364 · Ouverte le 5/4/2022
Problem creating changelog in HTML Ouverte

Difficulté 3/5 1-2 jours Accessibilité débutants 35/100

OpenAPITools/openapi-diff#362 · Ouverte le 4/4/2022
ChangedSchema in a readOnly property for requestBody is not filtered out from the result. Ouverte

Difficulté 4/5 3-5 jours Accessibilité débutants 48/100

OpenAPITools/openapi-diff#357 · Ouverte le 24/3/2022
Template-based output Ouverte

enhancement help wanted

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100

OpenAPITools/openapi-diff#355 · 1 réaction · Ouverte le 15/3/2022
Removing a security scheme is considered incompatible Ouverte

Breaking/Non-Breaking classification question

Difficulté 4/5 3-5 jours Accessibilité débutants 35/100

OpenAPITools/openapi-diff#330 · 1 commentaire · Ouverte le 28/1/2022
False positive breaking change when making a required request body optional Ouverte

Breaking/Non-Breaking classification

Difficulté 3/5 1-2 jours Accessibilité débutants 38/100

OpenAPITools/openapi-diff#329 · 6 réactions · Ouverte le 28/1/2022
Markdown output does not contain compatibility information Ouverte

Difficulté 3/5 1-2 jours Accessibilité débutants 45/100

OpenAPITools/openapi-diff#325 · 2 commentaires · 12 réactions · Ouverte le 18/1/2022
Evaluate creating native images Ouverte

enhancement

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100

OpenAPITools/openapi-diff#310 · Ouverte le 27/12/2021

OpenAPITools/openapi-diff

Recevez les nouvelles issues par e-mail