Control de versiones
La versión 1 de la API pública está bajo /api/public/v1. Esta página indica qué puede cambiar dentro de ella y cómo te llega un cambio que rompería tu integración.
Solo adiciones dentro de una versión
Sección titulada «Solo adiciones dentro de una versión»Los cambios dentro de la versión 1 son solo adiciones: nuevas operaciones, nuevos campos opcionales y nuevos valores de enumeración. Diseña tu integración para aceptar campos de respuesta y valores de enumeración que no conoce.
Un cambio incompatible se publica bajo un nuevo espacio de nombres, /api/public/v2, junto a la versión 1, que sigue respondiendo hasta su fecha de retirada.
Obsolescencia
Sección titulada «Obsolescencia»Una operación que va a desaparecer se marca primero como obsoleta, al menos 90 días antes de retirarla, o 30 días para una operación marcada como beta. A partir de entonces, cada una de sus respuestas lleva tres encabezados:
| Encabezado | Significado |
|---|---|
Deprecation | Cuándo se marcó como obsoleta la operación |
Sunset | Cuándo deja de responder |
Link | Un enlace a esta página, con rel="deprecation" |
El registro de cambios de la API recoge cada obsolescencia y cada nueva operación.