En esta categoría recojo cambios de APIs cuando el asunto da para algo más que una nota rápida. Puede ser una versión nueva, un endpoint que se mueve, una respuesta que cambia de forma, un límite que aparece, una autenticación que se ajusta o una integración que deja de encajar como antes.
Ejemplo, cuando Twitter lanzó la API v2 en 2020, muchos endpoints dejaron de comportarse como en la v1.1 y más de uno se llevó un susto. A veces el cambio mejora. Otras, desplaza el problema y te obliga a coger los parches.
Una API no vive solo en la documentación. Vive con quien la integra, la prueba y se da de cara con los fallo.