Visión general#
El software moderno depende fuertemente de APIs de terceros. Aunque permiten integrar y desarrollar más rápido, esas APIs también evolucionan con el tiempo. Los endpoints cambian, se retiran versiones y algunos servicios completos llegan a su fin de vida (EOL). Cuando ocurren estas transiciones, las aplicaciones que dependen de versiones antiguas corren el riesgo de romperse inesperadamente.
Este directorio ofrece una forma organizada de explorar APIs obsoletas, entender cómo los proveedores anuncian cambios y analizar el ciclo de vida de las interfaces públicas desde una perspectiva técnica.
Por qué importan las deprecaciones de APIs#
Una API deprecada normalmente sigue funcionando, pero está marcada para ser retirada en un futuro cercano. Esta fase es una señal crítica para los equipos de ingeniería. Ignorarla puede llevar a:
- Cambios incompatibles después de una migración forzada
- Comportamientos inesperados debidos a capas de compatibilidad
- Caídas de servicio cuando finalmente se elimina un endpoint
- Mayor coste operativo provocado por refactors de emergencia
- Problemas de seguridad o de cumplimiento cuando se retiran interfaces heredadas
Cómo anuncian los proveedores los cambios en sus APIs#
Cada proveedor sigue su propio estilo de comunicación. Los mecanismos más habituales incluyen:
- Changelogs o notas de versión
- Actualizaciones en la documentación oficial
- Correos electrónicos a desarrolladores registrados
- Publicaciones en blogs técnicos
- Cabeceras de versionado en las respuestas de la API
- Paneles para desarrolladores
- Calendarios públicos de deprecación de APIs o hojas de ruta de EOL
Como estas fuentes difieren en formato y fiabilidad, entender los patrones específicos de cada proveedor es esencial.
Ciclo de vida de una API: desde la introducción hasta el EOL#
El ciclo de vida de la mayoría de APIs públicas suele incluir las siguientes etapas:
- Introducción – primera publicación de una API o de una versión mayor.
- Disponibilidad general – fase estable y lista para producción.
- Mantenimiento – pequeñas actualizaciones y mejoras de compatibilidad.
- Deprecación – la API se marca como obsoleta y se anuncia un reemplazo recomendado.
- Fin de vida (EOL) – la API deja de estar disponible; las llamadas empiezan a fallar o se redirigen a nuevas interfaces.
Este sitio recopila ejemplos reales de estos estados para APIs y proveedores concretos, con el objetivo de ayudar a los equipos a anticipar riesgos, planificar migraciones y entender mejor cómo se gestionan los cambios en el ecosistema de APIs.