OpenAPITools/openapi-diff

Ver en GitHub

Utility for comparing two OpenAPI specifications.

Estrellas: 1.1k
Forks: 190
Issues abiertos para principiantes: 0
Issues indexados: 69

Lenguaje dominante: Java
Licencia: Apache-2.0
Último push a GitHub: 5/8/2026
Última indexación: 19/9/2026
Guía de contribución: Guía de contribución
Código de conducta: Código de conducta
Etiquetas para principiantes: help wanted good first issue
Métricas de merge de PR: Sin PR fusionados en 30 d

Para principiantes Todo

Abierto Todos

69 issues abiertos indexados

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

bug OpenAP 3.1.0 Support

Dificultad 3/5 1-2 días Aptitud para principiantes 68/100

OpenAPITools/openapi-diff#910 · 1 comentario · Abierto el 12/6/2026
Changes reported in operations but only securityScheme changed Abierto

Render capabilities

Dificultad 3/5 1-2 días Aptitud para principiantes 55/100

OpenAPITools/openapi-diff#893 · 1 comentario · Abierto el 25/2/2026
[Bug] Backward compatibility check fails on reordered discriminator mappings Abierto

Breaking/Non-Breaking classification

Dificultad 3/5 1-2 días Aptitud para principiantes 55/100

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

Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100

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

Render capabilities

Dificultad 3/5 1-2 días Aptitud para principiantes 48/100

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

OpenAP 3.1.0 Support

Dificultad 3/5 1-2 días Aptitud para principiantes 45/100

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

Render capabilities

Dificultad 3/5 1-2 días Aptitud para principiantes 45/100

OpenAPITools/openapi-diff#857 · Abierto el 7/11/2025
TeamCity renderer Abierto

Render capabilities

Dificultad 4/5 3-5 días Aptitud para principiantes 35/100

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

enhancement Render capabilities

Dificultad 3/5 1-2 días Aptitud para principiantes 35/100

OpenAPITools/openapi-diff#839 · 1 comentario · Abierto el 25/9/2025
Mark down changelog generation - enum rename interpreted as added Abierto

OpenAPITools/openapi-diff#828 · 1 comentario · 1 reacción · 1 asignado · Abierto el 11/9/2025
IllegalArgumentException: "Invalid ref..." when uses an external link like "../demo#/components" Abierto

Dificultad 3/5 1-2 días Aptitud para principiantes 35/100

OpenAPITools/openapi-diff#810 · 2 comentarios · 1 reacción · Abierto el 11/8/2025
Bug: erroneous detection of changes with mediaTypes, failure to generate html/markdown reports Abierto

Dificultad 3/5 1-2 días Aptitud para principiantes 45/100

OpenAPITools/openapi-diff#805 · 1 comentario · Abierto el 7/8/2025
Bug: no details when securitySchemes.*.name changes Abierto

OpenAP 3.1.0 Support

Dificultad 3/5 1-2 días Aptitud para principiantes 45/100

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

Breaking/Non-Breaking classification

Dificultad 3/5 1-2 días Aptitud para principiantes 48/100

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

Breaking/Non-Breaking classification

Dificultad 3/5 1-2 días Aptitud para principiantes 50/100

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

OpenAP 3.1.0 Support

Dificultad 4/5 3-5 días Aptitud para principiantes 42/100

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

bug

Dificultad 4/5 3-5 días Aptitud para principiantes 35/100

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

enhancement

Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100

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

Breaking/Non-Breaking classification Render capabilities

Dificultad 3/5 1-2 días Aptitud para principiantes 48/100

OpenAPITools/openapi-diff#766 · 1 comentario · 1 reacción · Abierto el 5/4/2025
Comparing OpenAPI 3.0.1 to 3.1.0 does not work Abierto

OpenAP 3.1.0 Support

Dificultad 4/5 3-5 días Aptitud para principiantes 35/100

OpenAPITools/openapi-diff#755 · 5 comentarios · 1 reacción · Abierto el 14/3/2025
[OpenAPI 3.1.0 support] JsonSchema type changes not handled. Abierto

OpenAP 3.1.0 Support

Dificultad 4/5 3-5 días Aptitud para principiantes 35/100

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

good first issue help wanted

Dificultad 3/5 1-2 días Aptitud para principiantes 45/100

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

Breaking/Non-Breaking classification duplicate

Dificultad 3/5 1-2 días Aptitud para principiantes 45/100

OpenAPITools/openapi-diff#694 · 2 comentarios · Abierto el 13/8/2024
Deleted or renamed properties are marked as backwards compatible Abierto

Breaking/Non-Breaking classification

Dificultad 3/5 1-2 días Aptitud para principiantes 52/100

OpenAPITools/openapi-diff#673 · 7 comentarios · 3 reacciones · Abierto el 14/6/2024
Report totals Abierto

enhancement

Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100

OpenAPITools/openapi-diff#627 · 1 reacción · Abierto el 5/3/2024
Output in text and markdown not equivalent (text output incomplete) Abierto

enhancement Render capabilities

Dificultad 4/5 3-5 días Aptitud para principiantes 30/100

OpenAPITools/openapi-diff#620 · 2 comentarios · 1 reacción · Abierto el 19/2/2024
No backward compatible changes in Schema are marked as Compatible Abierto

Breaking/Non-Breaking classification

Dificultad 4/5 3-5 días Aptitud para principiantes 35/100

OpenAPITools/openapi-diff#611 · 4 reacciones · Abierto el 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 Abierto

Dificultad 4/5 3-5 días Aptitud para principiantes 30/100

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

Breaking/Non-Breaking classification question

Dificultad 4/5 3-5 días Aptitud para principiantes 25/100

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

Dificultad 4/5 3-5 días Aptitud para principiantes 38/100

OpenAPITools/openapi-diff#571 · 1 comentario · Abierto el 21/9/2023
--json output is absurdly huge Abierto

enhancement Render capabilities

Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100

OpenAPITools/openapi-diff#562 · 1 comentario · 8 reacciones · Abierto el 8/9/2023
incompatible api diff result when one of property in model becomes not required Abierto

Breaking/Non-Breaking classification

Dificultad 3/5 1-2 días Aptitud para principiantes 38/100

OpenAPITools/openapi-diff#535 · 2 comentarios · 1 reacción · Abierto el 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 Abierto

Breaking/Non-Breaking classification

Dificultad 3/5 1-2 días Aptitud para principiantes 38/100

OpenAPITools/openapi-diff#528 · 1 comentario · 3 reacciones · Abierto el 2/6/2023
enum and properties change in schemas not reported in .md file generated after diff check Abierto

Dificultad 4/5 3-5 días Aptitud para principiantes 42/100

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

good first issue

Dificultad 2/5 1-3 horas Aptitud para principiantes 50/100

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

enhancement

Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100

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

Breaking/Non-Breaking classification

Dificultad 3/5 1-2 días Aptitud para principiantes 42/100

OpenAPITools/openapi-diff#490 · 3 comentarios · 1 reacción · Abierto el 14/3/2023
Using a reference in items of array results in error Abierto

duplicate

Dificultad 3/5 1-2 días Aptitud para principiantes 20/100

OpenAPITools/openapi-diff#464 · 3 comentarios · Abierto el 15/2/2023
Do not fail with breaking changes when major version is bumped Abierto

Breaking/Non-Breaking classification enhancement

Dificultad 4/5 3-5 días Aptitud para principiantes 35/100

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

Breaking/Non-Breaking classification help wanted

Dificultad 3/5 1-2 días Aptitud para principiantes 25/100

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

Dificultad 3/5 1-2 días Aptitud para principiantes 35/100

OpenAPITools/openapi-diff#392 · 4 comentarios · 2 reacciones · Abierto el 4/7/2022
Consider removal of deprecated elements as compatible Abierto

Breaking/Non-Breaking classification

Dificultad 5/5 Más de una semana Aptitud para principiantes 20/100

OpenAPITools/openapi-diff#371 · 4 comentarios · Abierto el 5/5/2022
HtmlRender: Notes of Parameters shows always the new description Abierto

good first issue help wanted

Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100

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

Dificultad 3/5 1-2 días Aptitud para principiantes 35/100

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

Dificultad 4/5 3-5 días Aptitud para principiantes 48/100

OpenAPITools/openapi-diff#357 · Abierto el 24/3/2022
Template-based output Abierto

enhancement help wanted

Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100

OpenAPITools/openapi-diff#355 · 1 reacción · Abierto el 15/3/2022
Removing a security scheme is considered incompatible Abierto

Breaking/Non-Breaking classification question

Dificultad 4/5 3-5 días Aptitud para principiantes 35/100

OpenAPITools/openapi-diff#330 · 1 comentario · Abierto el 28/1/2022
False positive breaking change when making a required request body optional Abierto

Breaking/Non-Breaking classification

Dificultad 3/5 1-2 días Aptitud para principiantes 38/100

OpenAPITools/openapi-diff#329 · 6 reacciones · Abierto el 28/1/2022
Markdown output does not contain compatibility information Abierto

Dificultad 3/5 1-2 días Aptitud para principiantes 45/100

OpenAPITools/openapi-diff#325 · 2 comentarios · 12 reacciones · Abierto el 18/1/2022
Evaluate creating native images Abierto

enhancement

Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100

OpenAPITools/openapi-diff#310 · Abierto el 27/12/2021

OpenAPITools/openapi-diff

Recibe los nuevos issues en tu correo