Versiones actuales
Versión en las URLs
El número de versión aparece en la ruta del endpoint:Cambios rompedores vs. no rompedores
Cambios rompedores (requieren actualizaciones de código)
Estos cambios solo ocurren en aumentos de versión mayor:- Eliminar un endpoint
- Eliminar un campo de respuesta
- Eliminar un parámetro de consulta
- Añadir un nuevo parámetro requerido
- Cambiar el tipo de dato de un campo
- Renombrar un campo o recurso
- Cambiar los códigos de respuesta o tipos de error
- Modificar los scopes de autorización
Cambios no rompedores (aditivos)
Estos pueden ocurrir en cualquier momento sin cambios de versión:- Añadir un nuevo endpoint
- Añadir un nuevo parámetro opcional
- Añadir un nuevo campo de respuesta
- Añadir nuevos scopes de OAuth
- Cambiar el texto de mensajes de error
- Anular campos por razones de privacidad/seguridad
Calendario de lanzamientos
Política de deprecación
Cuando lanzamos una nueva versión mayor:- Deprecación: La versión anterior se marca como deprecada
- Período de soporte: La versión deprecada sigue funcionando durante un período definido
- Retirada: La versión deprecada se elimina
Definiciones
Mantente informado
Recibe notificaciones sobre cambios:
Changelog
Todos los cambios y actualizaciones de la plataforma.
Anuncios del foro
Avisos de cambios rompedores.
@XDevelopers
Noticias y actualizaciones de la plataforma.
Newsletter
Resumen mensual.
Recursos de migración
Cuando se lanza una nueva versión, proporcionamos:- Guías de migración: Instrucciones de actualización paso a paso
- Mapa de endpoints: Equivalentes de v1 a v2
- Cambios de formato de datos: Diferencias del modelo de objetos
Descripción general de la migración
Orientación actual de migración.
Mapa de endpoints
Mapa de endpoints de v1 a v2.
Buenas prácticas
Usa v2
Comienza nuevos proyectos con la última versión.
Monitoriza anuncios
Suscríbete al changelog y a las actualizaciones del foro.
Prueba los cambios
Prueba en desarrollo antes de aplicar actualizaciones en producción.
Planifica migraciones
No esperes hasta la deprecación para actualizar.