Cambios de API
Cambios incompatibles, deprecaciones y versionado, contados a quienes les afectan.
-
Versionado de la API de Stripe: cómo funciona y qué copiar
Stripe fija cada cuenta a una versión con fecha y deja que cualquier petición la sustituya. Cómo funciona, qué cuesta y qué puede copiar una API pequeña.
Cambios de API8 min de lectura
-
Breaking changes de Protobuf: qué sobrevive en el wire
Los breaking changes de Protobuf ocurren en el wire, no en la URL. Algunos cambios de campo en gRPC son gratis, otros rompen a cada cliente en silencio.
Cambios de API7 min de lectura
-
Deprecación en GraphQL sin número de versión
GraphQL no tiene v1 ni v2 en la URL. Los campos se deprecan uno a uno con una directiva, en un esquema compartido, y eso cambia lo que exige un changelog.
Cambios de API6 min de lectura
-
Cómo escribir una guía de migración de API
Una guía de migración de API convierte un cambio incompatible en una checklist en vez de una caída. Qué necesita, y por qué una entrada no basta sola.
Cambios de API5 min de lectura
-
Changelogs de API internas: qué cambia para el otro equipo
Un changelog de API pública tiene un público al que no puedes contactar. Uno interno tiene un público a dos pisos, y eso cambia lo que debe incluir.
Cambios de API6 min de lectura
-
El header sunset de una API, y cuándo enviarlo
El header sunset de una API dice cuándo una versión dejará de responder, a diferencia de una deprecación. Qué cubre RFC 8594 y qué aporta un brownout.
Cambios de API6 min de lectura
-
Changelogs de webhooks: el breaking change que nadie pidió
Un cambio en el payload de un webhook rompe en silencio, porque nadie lo rechaza. Qué hace que un cambio de payload sea rompedor y cómo versionarlo.
Cambios de API6 min de lectura
-
Changelog de API: qué publicar y quién lo lee
Un changelog de API lo lee gente que decide si su código seguirá funcionando el próximo mes. Qué le debe cada entrada, dónde vive, cómo se suscriben.
Cambios de API7 min de lectura
-
Cómo deprecar una API sin perder a sus desarrolladores
La deprecación es una promesa con fecha. Calendario, plantilla de aviso, headers de respuesta y el paso que evita que un sunset sea un incidente.
Cambios de API7 min de lectura
-
Buenas prácticas de versionado de API, para los llamantes
Versiona solo lo que rompe algo, pon la versión donde los llamantes la vean, y mantén la vieja funcionando hasta una fecha. Cuatro esquemas comparados.
Cambios de API8 min de lectura
-
Cambios que rompen algo: qué cuenta y cómo lanzarlos
Un cambio que rompe algo es el que un llamante correcto no resistiría. Qué cuenta, qué no, cómo detectarlo en CI y cómo lanzarlo con seguridad.
Cambios de API10 min de lectura
