Compare specs
Una página dedicada (enlazada desde el sidebar como "Compare specs") que obtiene dos documentos OpenAPI por URL y reporta qué cambió entre ellos: endpoints añadidos, eliminados y modificados, cada uno marcado como breaking o informativo.
Uso
Haz clic en Compare specs en el sidebar, pega una URL para la spec base (antigua) y otra para la nueva (el campo nuevo viene prerellenado con la spec cargada actualmente), y luego haz clic en Compare. Ambos documentos pasan por el mismo pipeline normalizeDocument() que usa el visor principal, así que no hay un parser aparte del que fiarse.
Qué cuenta como breaking
| Change | Severity |
|---|---|
| Endpoint eliminado | Breaking |
| Nuevo parámetro obligatorio | Breaking |
| Parámetro opcional pasó a obligatorio | Breaking |
| El request body pasó a obligatorio | Breaking |
| Se eliminó una respuesta 2xx | Breaking |
| Endpoint añadido | Informativo |
| Parámetro eliminado | Informativo |
| Se eliminó una respuesta no-2xx | Informativo |
| Nuevo status de respuesta documentado | Informativo |
Alcance
Esto es deliberadamente superficial: compara presencia de endpoints, presencia/obligatoriedad de parámetros, obligatoriedad del request body, y códigos de estado de respuesta. No compara la forma del schema campo a campo (por ejemplo, una propiedad que cambia calladamente de string a number todavía no se detecta).